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INTRODUCTION 


La micro-informatique constitue la « nouvelle frontière » des années 
80. Si l’on exclut les connotations californiennes de l'expression, demeurent 
la notion de dépassement, d'aventure, de bouleversement constant des prin- 
cipes un temps considérés comme acquis. Pourtant, alors que tant de pas- 
sionnés passent des nuits entières devant leur écran et se soumettent à une 
formation permanente et accélérée aux innovations constantes de la techni- 
que, beaucoup d’auteurs conservent les mêmes stéréotypes vieillis. Combien 
de préfaces pour vanter les caractéristiques « inouïes et sans pareilles » de 
la machine étudiée (alors que le lecteur en est souvent convaincu !) ou, plus 
froidement et plus commercialement, pour affirmer que tout lecteur, néophy- 
te ou développeur, trouvera dans l’ouvrage ce qu’il n’a jamais trouvé ailleurs. 


512 Ko de mémoire vive, 192 Ko de mémoire morte, 95 touches dont 
10 de fonctions, haute résolution 640*400 points, interfaces parallèle, série, 
MIDI, lecteur 3,5 pouces double densité, microprocesseur 16/32 bits. natu- 
réellement les composantes techniques d’un système micro-informatique ont 
une importance et cet ouvrage ne faillira pas à la tradition, dans la mesure 
où seront étudiées chacune de ces caractéristiques. Mais le lecteur recher- ‘ 
chant un dépliant publicitaire pourra s’adresser à son revendeur habituel, 
essayer un 520 ST et les machines concurrentes et décider en connaissance 
de cause, 


Cet ouvrage s’adresse exclusivement au programmeur, de préférence en 
langage C ou en assembleur. À celui-ci, l’auteur à l’espoir insensé d’appor- 
ter des méthodes de programmation, à travers de multiples exemples, ainsi 
qu’une somme d’informations de référence. Il semblerait même que tout pro- 
grammeur en C ou en assembleur 68000, sur 520 ST ou sur une autre machine, 
pourrait tirer quelque profit des pages qui suivent, mais peut-être y a-t-il là 
excès de forfanterie ou même tartufferie ! 


VII 


Un panorama des instructions de base du langage C et de l’assembleur 
68000 est fourni dans cet ouvrage, celui-ci ne saurait cependant suffire au 
programmeur débutant dans l’un de ces langages, auquel il est conseillé de 
se reporter aux ouvrages de référence en la matière, dont la bibliographie 
en annexe fournit un aperçu. 


Ce livre a été écrit sans précipitation excessive, afin de tenir compte des 
évolutions habituelles lors du lancement d’une machine. Certains compila- 
teurs C et assembleurs annoncés n’étant malheureusement pas encore dispo- 
nibles lors de la rédaction de ces pages, les exemples fournis ont été princi- 
palement développés sur l’assembleur et le compilateur C de Digital Research 
(pack de développement commercialisé par Atari France). Les modifications 
de dernière heure apportées au GEM ont été prises en compte et un désas- 
semblage complet du système d’exploitation nous permet de fournir ici quan- 
tité de précisions sur les différences rencontrées entre la version 520 ST du 
GEM et celles implementées sur d’autres machines. 


Une étude précise des circuits périphériques et spécialement du 6301 dédié 
aux entrées clavier et souris, ainsi que des cartes détaillées des différentes 
zones de mémoire, devraient fournir quelque aliment au « bidouilleur » ou, 
plus noblement, au lecteur désireux d’outrepasser le cadre strict des applica- 
tions structurellement normées (et par le fait même courantes sinon rebat- 
tues). La ligue « À », orgueil du programmeur en assembleur 68000, est dis- 
séquée à la lumière de nombreux exemples. 


Les processus de compilation, d’assemblage et d’édition de liens, de par 
leur importance dans toute programmation, sont également analysés et quel- 
ques pièges couramment rencontrés lors de ces phases critiques sont explici- 
tés. Enfin, dans la mesure où il est possible d’utiliser en Basic les fonctions 
du système d’exploitation et du GEM, il nous a paru utile de détailler les 
règles d’utilisation de ces dernières à partir d’un langage certes lent mais connu 
de l’immense majorité des lecteurs. 


Surpris du silence général des auteurs sur la question primordiale des 
erreurs de programmation, dont la recherche occupe souvent un temps con- 
sidérable, nous avons mis l’accent, chaque fois que cela paraissait utile, sur 
les difficultés et les pièges rencontrés à l’utilisation des langages étudiés. Les 
méthodes de programmation et d’analyse d’erreur, tant en C qu’en assem- 
bleur, occupent donc une part non négligeable des pages qui suivent. 
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1. GÉNÉRALITÉS 


1.1. Organisation matérielle du 520 ST 


L'architecture matérielle du 520 ST peut être décomposée en trois systè- 
mes fonctionnels principaux : 


Le cœur, ordonné autour d’un microprocesseur 68000. Pourvu de 16 
lignes de données et de 24 lignes d’adresses, l'unité centrale du 68000 tra- 
vaille sur des opérandes de 32 bits et peut adresser jusqu’à 16 Mo de mémoire. 
Dans la version de base, 512 Ko de mémoire vive et 192 Ko de mémoire morte 
résident dans le 520 ST, Le microprocesseur peut par ailleurs accéder sans 
intermédiaire (DMA ou Direct Memory Access) à une cartouche de ROM 
enfichable dans l'appareil ainsi qu’à un disque dur éventuel. 


Le système graphique, lequel utilise 32 Ko de la mémoire vive, chacun 
des points de l’écran ayant un correspondant direct (un bit en noiïr et blanc, 
deux bits en 4 couleurs, quatre bits en 16 couleurs) dans cette mémoire d'écran 
(technique dite du Bitmap). En polychromie, les 4 ou 16 couleurs disponi- 
bles peuvent être choisies parmi une palette de 512 couleurs. 


Les différents systèmes d’entrée-sortie : clavier et souris pilotés par un 
microprocesseur, interface musicale constituée d’un synthétiseur de sons à 
trois voies et d’une entrée-sortie MIDI, interfaces parallèle et série, inter- 
face disquette et disque dur. 


1.1.1. Le microprocesseur 68000 


Examiner l’interfaçage matériel du 68000 avec l’ensemble des compo- 
sants du système dépasserait largement les limites de cet ouvrage. Seuls seront 


Î 
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examinées ici les caractéristiques de ce microprocesseur directement utiles 
et nécessaires pour la programmation en assembleur. 


Vrai 16 bits, c’est-à-dire effectuant les lectures et écritures de données 
sur seize lignes, le 68000 dispose de possibilités d’adressage étendues et sur- 
tout peut effectuer ses opérations internes sur 32 bits. Cadencé par un quartz 
à 8 MU, soit 8 millions de cycles machine par seconde, il exécute une addi- 
tion de deux entiers de 16 bits (donc compris entre — 32768 et + 32767) 
en 4 cycles machine soit 0.5 microseconde et une multiplication de deux entiers 
en 70 cycles maximum soit 8.75 microsecondes. 


Comme l'indique la figure en page 3, le 68000 dispose de : 


— 8 registres de données de 32 bits, sur lesquels sont possibles des opé- 
rations portant sur un octet (8 bits), un mot (16 bits) ou un long mot (32 bits). 

— 7 registres d’adresse de 32 bits (AO-A6) et un pointeur de pile (A7). 
Ces registres servent habituellement de pointeurs ou d’index mais peuvent 
aussi être utilisés comme registres de calcul, Le pointeur de pile constitue 
en fait un double registre, comme il est expliqué plus bas. 

— 1 compteur de programme (PC), dont seuls les 24 bits inférieurs sont 
utilisés. Ce registre pointe en permanence l'adresse de l'instruction exécutée 
par le microprocesseur. Il est son repère. 

— 1 registre d’état (SR) de 16 bits. Ce registre indique les conséquen- 
ces de l'exécution des instructions au fur et à mesure de celle-ci (retenue, 


résultat nul, etc.) ainsi que les états du microprocesseur (interruption, mode). _ 


Tous ces registres font partie intégrante du microprocesseur et n’ont donc 
naturellement pas d’adresse mémoire. Ils forment la zone de travail du 68000 
et sont, par conséquent, très rapidement accessibles. Ainsi, alors que le report 
du contenu d’un registre de données de 32 bits dans un autre registre de don- 
nées est opéré en 4 cycles machine (soit 0,5 microseconde), le report du contenu 
d’une mémoire de 32 bits dans une autre mémoire nécessite 28 cycles (soit 
3.5 microsecondes). 

Les registres d’adresses, s’ils constituent la source d’une instruction, peu- 
vent être employés comme une ZONE de 16 ou de 32 bits, selon la taille préci- 
sée par l'instruction mais, si l’un de ces registres constitue la destination, 
ilest entièrement concerné, c'est-à-dire que les 32 bits du registre sont affec- 
tés. Si le bit fort du mot placé dans le registre d’adresse est nul, alors le mot 
fort du registre d'adresse est mis à $0000, sinon le mot fort est mis à Sffff. 


A la différence de certains microprocesseurs courants comme le Z80 ou 
la famille 8086, le 68000 manipule les adresses dans leur sens « logique » ! 
Ainsi, si l’on place l'adresse $0006 75F3 dans le registre d'adresse AO, la partie 
haute 00 de l'adresse sera placée dans l’octet du haut (fort) puis 06 sera placé 
dans l'octet suivant, et 75 et F3 dans les deux suivants. 
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\ compteur de programme 


15 [0] 
C Superviseur JT Utilisateur "| 


Contrairement également aux microprocesseurs pré-cités, une instruc- 
tion du 68000 comporte toujours le code de la source avant celui de la desti- 
nation, Ainsi « move D1, (A2) » met le contenu du registre de données D1 
dans la mémoire dont l'adresse est contenue dans le registre d’adresse A2. 


L'une des spécificités du 68000 est constituée par le double mode de fonc- 
tionnement possible : mode SUPER VISEUR et mode UTILISATEUR. Cette 
distinction, initialement prévue pour faciliter le multi-utilisateur, est prise 


3 
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en compte par le 520 ST : la partie basse de la mémoire ne peut être lue ou 
écrite qu’en mode superviseur (adresses 0 à $7FF), le reste étant accessible - ù 
dans les deux modes. Cette protection des mémoires basses, lesquelles con- 
tiennent les variables système, fera l’objet de développements ultérieurs (cf. 
chapitre 3). n. 


En dehors de cette distinction des espaces mémoire adressables, le passage 
de mode superviseur en mode utilisateur, et vice-versa, a les caractéristiques 
suivantes : 


Mode SUPERVISEUR 


Conditions d’accès : toute interruption matérielle ou logicielle. 

Test de mode : bit 13 du registre d’état SR à 1. 

Instructions interdites : aucune, 

Registres accessibles : DO à D7, A0 à A6 et pointeur de pile superviseur. 
Masquage des interruptions : possible. 

Mode TRACE : possible. 


Mode UTILISATEUR 


Conditions d’accès : après une sortie du superviseur par RTE ou par la mise 
à zéro du bit 13 du registre d’état SR. 
Test de mode : bit 13 du registre d’état SR à 0. 


Instructions interdites : dites « privilégiées », ce sont : < 
STOP : mise en attente du microprocesseur 
RESET : validation de la ligne Reset 
RTE : retour d’interruption 


MOVE.W <donnee>, SR : place un mot dans le registre d’état 
ANDI.W <donnee>, SR : ET logique avec le registre d'état 
EORI.W <donnee>, SR : OU exclusif avec le registre d’état 
ORI.W <donnee>, SR  : OU logique avec le registre d’état 


&MOVEA.L An, USP : charge une adresse dans le pointeur de pile 
utilisateur 
MOVEA.L USP, An : stocke le pointeur de pile utilisateur dans 


un registre d'adresse 
Registres accessibles : DO à D7, A0 à A6 et pointeur de pile utilisateur. 
Masquage des interruptions : impossible. 
Mode TRACE : impossible. 


Le registre d'état, comme on le constate, est fortement affecté par le 
mode de fonctionnement du 68000. Son bit 13 reflète ce mode et l’octet fort 
de ce registre ne peut être modifié en mode utilisateur. Ce registre SR a la 
structure suivante : 


octet superviseur 8 7 octet utilisateur Li) 
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Trace Mode interruptions ] À éoaus 
dépassement 
Zéro 
négatif 
extension 


Les bits 5 à 7, 11, 12 et 14 du registre d'état sont inutilisés et toujours 
nuls. Seuls deux niveaux d’interruptions (niveaux 2 et 4) sont utilisés sur le 
520 ST. Ils correspondent à la mise à 1 du bit 9 et du bit 10 du registre d’état, 
respectivement. Ces interruptions seront étudiées au chapitre 5. 


Le jeu d'instruction du 68000 et son utilisation feront l’objet du chapi- 
tre 3 et de l’Annexe 5. 


1.1.2. Système graphique 


Avec un moniteur monochrome, la résolution graphique du 520 ST est 
de 640 x 400 points, soit 256 000 points. Chacun de ceux-ci peut être noir 
ou blanc. Pour conserver en mémoire ja valeur de ces points, il faut donc 
256 000 bits, soit 256 000/8 = 32 000 octets. Ces 32 000 octets constituent 
la mémoire d'écran, laquelle est stockée dans la partie haute de la mémoire 


vive, soit de $78000 à $7FCFF dans la version de base du 520 ST. 


On notera à ce propos que 32 000 octets ne font pas 32 Ko, puisqu’un 
Ko est égal à 2a10 octets, soit 1024 octets. Le lecteur attentif pourra s’inter- 
roger sur l’utilisation des 768 octets restants (de $7FCFF à $7FFFF). Avec 
raison. car ils sont inutilisés ! Pour un motif demeuré obscur, linitialisa- 
tion du système aligne le début de la mémoire d’écran sur un compte entier 
de Ko, donc inéluctablement en $78000 ! 


Aux 640 points horizontaux de l’écran, dans une résolution monoch- 
rome, correspondent 80 octets. Chacune des lignes de l’écran est donc tra- 
duite par 80 octets successifs. Si le premier octet de la mémoire d'écran, 
d'adresse $78000, est égal à $62, soit 0110 0010 en binaire, cela signifiera 
que les deuxième, troisième et septième points de la première ligne de l'écran 


sont noirs, etc. 


Avec un moniteur polychrome (ou une télévision, via la prise Peritel), 
deux résolutions sont disponibles : 


— Ja moyenne résolution, 640 « 200 points, soit 128 000 points pouvant pren- 
dre 4 couleurs. 


z. 


on 


_— Ja basse résolution, 320 + 200 points, soit 64 000 points pouvant prendre 
16 couleurs. 


Aux 128 000 points de la moyenne résolution correspondent toujours 
32 000 octets car un point nécessite deux bits pour le codage de la couleur : 
00 code de la couleur blanche 
01 code de la couleur rouge 
10 code de la couleur verte 
11 code de la couleur noire 

Aux 64 000 points de la basse résolution correspondent aussi 32 000 
octets, un point nécessitant quatre bits pour le codage de la couleur : 


0000 code de la couleur blanche (8777) 
0001 code de la couleur rouge {5700} 
0010 code de la couleur verte {($070) 
0011 code de la couleur jaune (8770) 
0100 code de la couleur bleue (8007) 
0101 code de la couleur magenta (5707) 
0110 code de la couleur cyan ($077) 


0111 code de la couleur blanc cassé (6565) 
1000 code de la couleur grise 15333) 
1001 code de la couleur rose (5733) 
1010 code de la couleur vert clair (5373) 
1011 code de la couleur jaune clair (5773) 
1100 code de la couleur bleue claire (5337) 
1101 code de la couleur magenta clair (8737) 
1110 code de la couleur cyan clair (15377) 
1111 code de la couleur noire ($000) 
On notera que ce nuancier ne respecte pas vraiment la hiérarchie des 
couleurs ni même les harmonies de tons. L'électronique a ses raisons. Les 
valeurs hexadécimales entre parenthèses correspondent aux valeurs de ces 


couleurs dans la palette de base du 520 ST. 


Pour envoyer les signaux vidéo correspondant à chacune des 4 ou des 
16 couleurs utilisées en moyenne et basse résolution, le système consulte en 
effet une palette (stockée en mémoire), laquelle fournit pour chacune des 
couleurs le pourcentage de rouge, de vert et de bleu de cette couleur. Ce pour- 
centage est codé sur 3 bits (ce qui offre 8 possibilités par couleur fondamen- 
tale, donc un éventail possible de 8x8x8 soit 512 couleurs composites). En 
mémoire, la palette est codée ainsi : 


couleur O couleur 1 
fedcba9876543210 fedcba9876543210 
4 À 4 
rouge vert bleu rouge vert bleu 


Ainsi la couleur blanche, de code $777, correspond à une saturation de 
rouge, de vert et de bieu (100 %), tandis que le magenta clair correspond 


EE 


à 100 % de rouge, 37,5 % de vert et 100 % de bleu. Les pourcentages cor- 
respondent naturellement à des intensités chromatiques et non à des dosages 
proportionnels ! Il est loisible au programmeur de modifier ces pourcenta- 
ges, donc les couleurs de la palette, par le biais des instructions Setpallete 
(a) et Setcolor (a.b) (cf. Annexe 4. Traps). 


La haute résolution est dite mono-plan car il y a correspondance linéaire 
entre les points de l’écran et les bits de la mémoire d’écran : à deux points 
contigus d’une même ligne correspondent deux bits qui se suivent. À con- 
trario, la moyenne et la basse résolution sont dites multi-plans car les bits 
de couleur d’un même point ne sont pas contigus en mémoire écran. Cette 
mémoire est découpée en mots (de 16 bits) selon le principe suivant : 


4 couleurs 2 plans plan O plan 1 plan O plan 1 


16 couleurs 4 plans plan O plan 1 plan 2 plan 3 


Aünsi le premier point en haut à gauche de l’écran aura son premier bit 
de couleur codé dans le bit fort de $78000 (début de la mémoire écran) et 
son second bit de couleur codé dans le bit fort de $78002 (un mot plus loin), 
en mode moyenne résolution. En basse résolution son troisième bit de cou- 
leur correspondra au bit fort de $78004 et son quatrième au bit fort de 878006. 


Cette structure mono ou multi-plan est d’une importance capitale pour 
la bonne utilisation des fonctions GEM, spécialement avec un moniteur 
polychrome. A titre indicatif, la structure multi-plan, décomposant l'écran 
en unités factuelles de 16 points, est à la source du traitement graphique par 
entités horizontales de 16 points, lequel se traduit par exemple par des déca- 
lages horizontaux des fenêtres toujours égaux à des multiples de 16 points. 
Par contre les déplacements verticaux peuvent être effectués sur un décalage 
d’un point seulement. Il n’y a naturellement aucun obstacle théorique à un 
décalage horizontal inférieur à 16 points mais les problèmes de gestion de 
la mémoire écran en résultant sont sévères ! 


Une résolution intermédiaire entre la moyenne et la basse résolution est 
théoriquement possible et prévue dans les instructions GEM. Elle autorise- 
rait 8 couleurs avec un codage multi-plan sur 3 plans. Malheureusement cette 

” possibilité n’a pas été implementée dans le système d’exploitation du 520 ST. 
Il est vrai que 640 n’est pas divisible par 3 ! 


1.1.3. Sous-systèmes d'entrée-sortie 


Entrées-sorties clavier 


L'expression « entrées-sorties » en matière de clavier peut surprendre, 
mais le clavier étant contrôlé par un microprocesseur 6301, il est effective- 
ment possible d’envoyer des commandes vers le clavier, par exemple pour 
une reconfiguration (cf. exemple du chapitre 5). 


Le microprocesseur 6301 est un circuit peu connu puisqu’utilisé seule- 
ment pour des automates industriels et un micro-ordinateur : le portable 
HX-20 d’Epson. Il s’agit d’une version C-MOS, légèrement modifiée, du 6801, 
lui-même dérivé du fameux 6800 de Motorola. 


Le 6301 est un véritable micro-ordinateur puisqu’il contient une RAM : 


de 128 octets, une ROM de 4 Ko, une interface série rapide et un program- 
mateur intégrés. Cadencé par un quartz à 4 Mhz sur Le 520 ST. le 6301 exé- 


cute un million de cycles par seconde. L'interface série rapide fonctionne 
à une vitesse de 7 812.5 bits/seconde. 


Les fonctions du 6301 sont multiples : 


_— contrôle de l’état des touches du clavier 

_- contrôle de la position de la souris 

_ contrôle des boutons de la souris 

__ contrôle de la (ou des) manette(s) de jeu (position du manche et bouton 
de mise à feu) 

— gestion de l’horloge du 520 ST (date et heure) 


Disposant d’un compteur de cycles (sur 16 bits) incrémenté tous les mil- 
lionièmes de secondes, le 6301 peut également faire office de base de temps 
pour des temporisations très fines. Cette possibilité et de nombreuses autres, 
plus classiques, feront l’objet d’une analyse détaillée au chapitre 5. 


Synthétiseur de son 


Le générateur de son programmable YM 2149 dont est doté le 520 ST 
est sans doute l’un des circuits les moins utilisés. puisqu’aucune des appli- 
cations développées jusqu'ici n’a, à notre connaissance, utilisé ses possibili- 
tés sinon pour un vague bruitage répétitif ! Il est vrai que la documentation 
le concernant est plus que restreinte et que seule une instruction du système 
d'exploitation autorise son emploi. 


Ce circuit offre pourtant des ressources étendues puisqu'il comporte trois 
canaux de sortie programmables indépendants, un générateur de bruit blanc 
mixable séparément avec chacun des canaux et un générateur d’enveloppe 
doublé d’un contrôle de l’amplitude de l'enveloppe. Utilisant une fréquence 


d'horloge de 2 MHZ, la base de temps est divisée par 16 pour la génération 
de l'onde carrée de chacun des canaux, d’où une valeur de la période de son 
de 8 microsecondes, ce qui autorise la sortie de son compris entre 30.5 Hz 
et 125 KHz. 


16 registres de base de 8 bits sont disponibles, dont 2 constituent des 
ports d’entrées sorties sans rapport avec la production de sons. Ces registres 
ont la fonction suivante : 


Registres 0 et I : les bits 0 à 3 du registre 1 constituent les bits forts de la 
fréquence de sortie du canal A et les bits O à 7 du registre 0 constituent les 
bits faibles de cette fréquence de sortie. Les bits 4 à 7 du registre 1 sont inu- 
tilisés. La fréquence est donc calculée sur 12 bits, selon le schéma : 


registre 1 registre O 
b3 b2 b1 b0O b7 b6 b5 b4 b3 b2 b1 bO 


Exemple : si registre 1 = $3 et registre O = $40, on aura compteur = ($3 x 256) + 
($40) = 768 + 64 = 882 

soit une période de : 832 « 8 = 6 656 microsecondes, correspondant donc à une fré- 
quence de 150.24 Hz 


Registres 2 et 3 : identiques aux registres O et 1 pour le canal B. 
Registres 4 et 5 : identiques aux registres 0 et 1 pour le canal C. 
Registre 6: Générateur de bruit. 
Les 5 bits faibles (0 à 4) de ce registre fixent la fréquence du 
générateur, laquelle peut varier de 977,5 Hz à 125 Khz. 
Registre 7: validation et mixage des registres précédents 
bit 0 : valide le ton du canal A si égal à 0 
bit 1 : valide le ton du canal B si égal à 0 
bit 2 : valide le ton du canal C si égal à 0 
bit 3 : mixe le générateur de bruit avec le canal A si égal à 0 
bit 4 : mixe le générateur de bruit avec le canal B si égal à 0 
bit 5 : mixe le générateur de bruit avec le canal C si égal à 0 
bit 6 : si nul, port À en entrée 
si égal à 1, port À en sortie 
bit 7 : si nul, port B en entrée 
si égal à 1, port B en sortie 
Registre 8 : registre d'amplitude du signal du canal A. 
Seuls les 5 bits faibles (0 à 4) sont utilisés. 
Le bit 4 détermine le mode. S’il est nul, l’amplitude est fixe, 
sinon elle est contrôlée par le générateur d’enveloppe. Les bits 
0 à 3 permettent de définir 16 niveaux d'amplitude. 
Registre 9 : identique au registre 8 pour le canal B 
Registre 10 : identique au registre 8 pour le canal C 


Registres 11 et 12 : période de l’enveloppe 
La fréquence de l’enveloppe est déterminée selon le principe 
suivant : les 8 bits du registre 12 sont les 8 bits forts de la période 
et les 8 bits du registre 13 sont les 8 bits faibles. Si ‘‘t” désigne 
le contenu des registres 11 et 12, la période est de : 
t « 128 microsecondes soit une fréquence de : 
1000000 / (tx128) Hz 
Registre 13 : Forme de l’enveloppe 
Celle-ci est définie par les 4 bits faibles du registre : 
bit 0 : retenue 
bit 1 : alternance 
bit 2 : attaque 
bit 3 : continuité 
Registre 14 : Port d’entrée-sortie A. 
bit 0 : sélection face disquette (0 = face 1) 
bit 1 : sélection du lecteur de disquette À si à 1 
bit 2 : sélection du lecteur de disquette B si à 1 
bit 3 : signal RTS pour interface série RS 232C 
bit 4 : signal DTR pour interface série RS 232C 
bit 5 : signal d'échantillonnage sortie parallèle 
bit 6 et 7 : inutilisés 
Registre 15 : Port d’entrée-sortie B. 
port de sortie parallèle (sur 8 bits). 


La programmation de ces registres, illustrée de quelques exemples, fera 
l’objet d’un développement au chapitre 5. 


Interfaces parallèle et série 


Les registres de contrôle et de sortie de l'interface parallèle correspon- 
dent au bit 5 du port À et au port B du circuit générateur de son étudié ci- 
dessus, L’entrée « Busy » (demande par l'imprimante d’interruption d'envoi 
des données) est par contre reliée à la ligne d’interruption 10 du circuit péri- 
phérique 68901, lequel contrôle également les lignes d’entrée-sortie de l’inter- 
face série RS 232C. Une étude précise de ce circuit sophistiqué dépasserait 
le cadre de cet ouvrage, aussi le lecteur est-il invité à se reporter au livre de 
P. Jaulent (« Circuits Périphériques de la famille 68000 », éd. Eyrolles, 1985). 


La vitesse de transmission série est initialisée à partir des registres de 
contrôle et de donnée du timer D du 68901. Le signal d’horloge de 76,8 Khz 
fournit la vitesse série après division selon le contenu des registres pré-cités. 
Les valeurs de division pour le registre de contrôle TCDCR sont les suivantes : 
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bit 2 bit 1 bitO division 
(eo) (e) 1 par 4 
[e) 1 (e] par 10 
0 1 1 par 16 
1 0 [e) par 50 
1 0 1 par 64 
1 1 [e) par 100 
1 1 1 par 200 


La fréquence obtenue est ensuite divisée par le contenu du registre de 
données du timer D. 


Exemple : si bits 0 à 2 de TCDCR = 001 
et registre de données = $C (12 décimal) 
la fréquence sera : (76800/4)/12 = 1600 bits/sec. 


Il est ainsi possible de programmer des vitesses d’entrée-sortie peu nor- 
malisées. Par contre certaines vitesses classiques sont ici approximatives. Ainsi 
la vitesse de 3600 bits/s est programmée avec 1 dans TCDCR et 5 dans TDDR 
(registre de données du timer D), ce qui correspond en fait à une fréquence 
de 3840 bits/seconde. Le tableau ci-dessous fournit les valeurs respectives 
à employer dans TCDCR et TDDR pour quelques vitesses courantes : 


TCDCR TDDR TCDCR TDDR TCDCR TDDR 
19200 1 1 960 1 $14 150 1 $80 
9600 1 2 800 1 $18 120 1 $AO 
6400 1 3 600 1 $20 100 1 $co 
4800 1 4 480 1 $28 75 3 $40 
8200 1 6 400 1 $30 60 3 $50 
2400 1 8 300 1 $40 56.9 3 $54 
1920 1 $ A 240 1 $50 50 3 $60 
1200 1 $10 200 1 $60 45,5 2 $A9 


Les trois dernières vitesses correspondent à des fréquences RTTY... 


Autres entrées-sorties 

Une entrée et une sortie MIDI sont destinées à la communication avec 
un synthétiseur. Elles sont considérées par le 520 ST comme une entrée et 
une sortie série, dont la vitesse est fixée à 31 250 bits/seconde. 


L’interfacage des lecteurs de disquettes s’opère par le biais d’un circuit 
WD 1770 tandis que l’interfacage du disque dur s'effectue via un contrôleur 
de DMA (Accès direct à la mémoire). 


Les adresses mémoires des variables système liées aux entrées-sorties sont 
fournies en Annexe 3. Nous reviendrons par ailleurs, dans le chapitre 5, sur 
l'utilisation des informations qui précèdent, à travers quelques exemples de 
manipulation directe des entrées-sorties. 


1.2. Organisation logicielle du 520 ST 


Pour relier l’ensemble des composants matériels précédemment décrits 
et pour permettre à l’utilisateur d’en profiter pleinement, un système d’exploi- 
tation de base est indispensable. Appelé TOS (pour Tramiel Operating 
System), il regroupe l’ensemble des routines de démarrage du système, de 
gestion de la mémoire et de gestion des entrées-sorties. 

Naturellement écrit en assembleur, ce système est fortement inspiré dans 
sa structure du CP/M 68K, c’est-à-dire de la version du CP/M pour micro- 
processeur 68000. La distinction entre le BDOS (système d'exploitation dis- 
que) et le BIOS (gestion des entrées-sorties) est bien effectuée, les primitives 
de base du CP/M se retrouvent. Mais il serait bien peu sérieux d’affirmer 
que le 520 ST possède un système d’exploitation CP/M : 


1) le CCP (programme de contrôle) est inexistant et n’est disponible que 
dans le système de développement commercialisé séparément. Certaines pri- 
mitives essentielles du CCP telle que la commande PIP ne sont d’ailleurs 
pas implementées dans ce programme. 

2) l’ensemble des exceptions (Trap 2) qui servent en CP/M 68k à l'appel 
des primitives système est absent du TOS, 


Se permettant une réflexion tout à fait subjective, l’auteur peut affir- 
mer qu’il n’y a rien là de dramatique, le CP/M étant relativement lourd 
d'emploi et inadapté aux 16 bits, surtout lorsque ceux-ci disposent du GEM 
et d’une souris ! Quel intérêt aurait la commande PIP quand un simple cli- 
quage et déplacement de souris permet de copier un fichier ? 


Car le TOS n’est que la première couche du système d’exploitation, si 
l’on considère celui-ci dans le sens large de l’ensemble des routines système, 
Une deuxième couche, dite VDI (« Virtual Device Interface »), regroupe 
l’ensemble des fonctions graphiques tandis qu’une troisième couche, dite AES 
(« Application Environment Services »), comprend l’ensemble des routines 
de gestion des fenêtres, de manipulation de la souris, de déroulement des 
menus, etc. Le VDI et l’AES forment les deux volets du GEM (« General 
Environment Manager »), ils sont toutefois dissociables et il existe même une 
instruction permettant d'éliminer l’AES de la mémoire, tant que celui-ci est 
en mémoire vive naturellement ! 


A titre indicatif, l’ensemble des routines d’entrée-sortie et de gestion des 
disquettes occupe environ 16 Ko dans le système fourni en janvier 86 (non 
compris les routines de démarrage du système et les zones de variables), alors 
que le VDI occupe environ 56 Ko et l’AES 96 Ko (non compris également 
les zones de variables). Il est vrai que le VDI comme l’AES ont été écrits 
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en langage C, ce qui ne joue pas en faveur de la concision du fichier objet 
produit. 


Mises à part les routines de démarrage du système et de traitement des 
interruptions, l’ensemble des routines du TOS et du GEM sont disponibles 
pour le programmeur en C comme en assembleur. Nombre de ces routines 
sont également utilisables en Basic via les instructions VDISYS et GEMSYS. 


La procédure d’appel est naturellement différente en assembleur et en 
C bien que l’utilisation de macros contribue à rapprocher fortement ces deux 
langages sur ce point précis. Cette procédure, caractéristique du 68000, uti- 
lise les exceptions (« Trap »), autrement dit des interruptions logicielles. A 
l’appel d’un Trap, le microprocesseur passe en mode superviseur, place dans 
le compteur de programme l'adresse du vecteur de Trap et exécute la rou- 
tine débutant à cette adresse puis, après exécution, repasse en mode utilisateur. 


Le 68000 autorise 16 niveaux d’exceptions, numérotés Trap 0 à Trap 
15. Sur le 520 ST, seuls 4 de ces niveaux sont utilisés par le système d’exploi- 
tation (les autres étant disponibles à l'utilisateur). Ce sont : 


TRAP 1: ensemble des routines BDOS (gestion disques et système) 
TRAP 2 : ensemble des routines GEM (VDI et AES) 

TRAP 13 : primitives d’entrée-sortie (BIOS) 

TRAP 14 : primitives supplémentaires d'entrée-sortie (TOS]) 

La sélection de telle ou telle routine dans un même Trap est effectuée 
en fonction des paramètres empilés avant l’appel, ou du contenu du registre 
de données DO pour Trap 2. L'utilisation de ces Traps fait l’objet d’exem- 
ples au chapitre 3 et une analyse exhaustive en est faite en Annexe 4. 


1.3. Langages de programmation 


A la rédaction de ces lignes étaient déjà disponibles pour le 520 ST : 


— Le Basic d’Atari, très complet bien qu’encore imparfait. 

— Le Logo d’Atari, version également très complète du Dr Logo. 
— Deux compilateurs de langage C, deux autres étant annoncés. 
— Trois assembleurs 68000. 

— Un compilateur Forth, deux autres étant annoncés. 

— Un compilateur Modula 2. 


Étaient d’autre part en cours d’adaptation deux compilateurs Pascal et 
un compilateur Lisp, sans parler d’autres projets inconnus de l’auteur. Le 
moins que l’on puisse dire est que le choix est large ! Aussi, pour ne pas trans- 
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former ce livre en encyclopédie, a-t-il fallu choisir de n’étudier ici que la pro- 
grammation en langage C et en assembleur, sans toutefois écarter quelques 
références au Basic. Ces langages étant les plus utilisés, donc les mieux connus, 
par l’auteur, il y a certes un parti-pris évident mais qui envisagerait de déve- 
lopper un programme de quelque importance en Logo ? Quant au Forth et 
à Modula 2, leur diffusion publique demeure marginale. Enfin, les avanta- 
ges du Pascal pèsent moins lourd que ses inconvénients face au langage C. 


La querelle des partisans de l’assembleur et des fanatiques du C est pas- 
sée de mode tant la race des programmeurs en assembleur semble en voie 
de disparition ! Il est hors de question de trancher ce débat par quelques for- 
mules, mais la lecture de cet ouvrage devrait permettre de mieux cerner les 
avantages et les inconvénients de chacun de ces langages. 


On relèvera que les manipulations fines des entrées-sorties, surtout 
lorsqu'elles sont peu orthodoxes, demeurent la chasse gardée de Passembleur. 
À titre d'exemple, il n’est pas prévu dans les fonctions graphiques disponi- 
bles en C d’afficher un caractère d’une couleur avec un fond de caractère 
différent du fond d'écran. Reconnaissons cependant qu’il s’agit d’un cas de 
figure dont la pratique du programmeur n’est pas forcément émaillée ! 


Aussi parfaite soit-elle, la compilation d’un langage ne saurait, quoi qu’il 
en soit, produire un fichier objet aussi rapide d’exécution qu’un programme 
écrit directement en assembleur, ne serait-ce qu’à cause du traitement géné- 
ral devant être opéré par l’assembleur. Le traitement d’une boucle vide en 
assembleur et en langage C en est une illustration : 


Version assembleur : 


tent 
main ï 
move.w  #9999,d0 8 cycles machine 
boucle 
dbra d0.boucle 10 cycles * 10000 
rts 16 evcles machine 
-end total : 100024 evcles 


Version normale en langage C : 


main () 
{ 
int i: 
for (i=9999:i2=0ti--); 
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Cette version une fois compilée produit le code suivant : 


_main 


link ab, #$tffa 16 cycles 

move.w  H$270F.$fffe (ab) 16 cycles 

bra test 10 cycles 
boucle 

subq.w  #$1,$fffe(ab) 16 cycles * 10000 
_test 

tst.w $FfFe (ab) 12 cycles + 10000 

bge _boucle 10 eveles # 10000 + 12 

unik ab 12 cycles 

rts 16 cycles 


380094 cvcles 
Une version C plus concise peut être écrite, qui utilise un registre comme 
compteur de boucles : 


main()° 
{ 
register d; 
for (i=9999:19=0si--); 


Cette version, une fois compilée, fournit le code suivant : 


_main 


link ab, #50 16 cycles 
movem,l db-d7,-(a7) 24 cycles 
move.w  ##270F,d7 16 cycles 
bra test 10 cycles 
boucle 
subq.wu  #$1,d7 4 cycles # 10000 
_test 
tst.w d7 4 cycles + 10001 
bge boucle 10 cycles + 10000 + 12 
movem.l (a7)+,db-d7 28 cycies 
unik ab 12 cycles 
rts 16 cycles 


180139 cycles 


On constate qu’une boucle vide de 10 000 pas est exécutée en 12,5 ms 
si elle est écrite en assembleur contr 47,5 ms en langage C. Il est vrai que 
la deuxième version en C est exécutée en 22,5 ms, mais l’utilisation d’une 

4 variable de type register est rare en C et non naturelle alors qu’elle est la 
règle en assembleur. Le lecteur expérimenté aura sans doute noté la redon- 
dance du fichier compilé. Ainsi le « Link » et l’« unlk » sont inutiles dans 
la deuxième version, de même que l’empilement du registre D6. Surtout, dans 
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les deux versions, l’instruction « tst.w » est superfétatoire puisque le 
« subq.w » qui précède (de même que le move.w de début) positionne les 
drapeaux du registre d'état ! 


A titre comparatif, la boucle Basic (« for i = 0 to 10000: next i ») est 
exécutée en 8,5 secondes par le Basic Atari, performance bien supérieure à 
nombre de Basic mais naturellement hors de proportion d’avec les précédents 
langages. 


La comparaison précédente, volontairement simpliste bien que nécessi- 
tant quelques connaissances de base en Cet assembleur 68000 pour être appré- 
ciée à sa juste valeur, offre un autre intérêt que les mesures de « timing ». 
Elle permet d'appréhender la différence de taille d’un code objet assembleur 
et compilé. Cette différence est d’autant plus nette que les routines compi- 
lées sont décomposées en modules élémentaires et que les variables utilisées 
ne sont pas du type « register » 


Il demeure que la programmation en langage C est moins astreignante 
et plus rapide que la programmation en assembleur et la moindre rapidité 
n’est pas un inconvénient pour la majeure partie des programmes, surtout 
avec un microprocesseur comme le 68000. Enfin, la génération d’un code 
objet plus important n’est pas un réel inconvénient lorsque la mémoire de 
base est de 512 Ko ! 


Avant d’aborder ces deux langages, il paraît utile de souligner que, si 
ja connaissance des instructions de base du C est indispensable pour pro- 
grammer dans ce langage (de même que la connaissance des instructions du 
68000 pour l’assembleur), cette connaissance n’est en aucun cas suffisante. 
Le niveau de sophistication du GEM et les nombreuses entrées-sorties du 
520 ST s’accommodent fort mal d’une programmation n’utilisant ni les fonc- 
tions GEM ni les fonctions système. L'idée de départ de cet ouvrage résulte 
d’ailleurs de ce constat : tout manuel de programmation générale en C où 
en assembleur est presque caduc face à une machine comme le 520 ST (essayez 
un exemple tiré d’un de ces ouvrages). D'autre part un simple manuel de 
référence fournissant, par exemple, les instructions GEM ou les adresses 
système, est d'utilisation difficile, surtout pour un programmeur amateur, 
et passe trop souvent à côté des problèmes pratiques rencontrés en 
programmation. 


2. PROGRAMMATION 
EN LANGAGE C 


Inventé dans les années 70 par Dennis RITCHIE pour écrire le système 
d'exploitation UNIX, le langage C devait rester longtemps l'apanage de la 
mini-informatique. Avec l’évolution des micro-ordinateurs et l'apparition 
pour ceux-ci des premiers compilateurs, la diffusion de C dépassa largement 
le cadre des seuls initiés. Et non sans raison, car ses qualités sont multiples. 


Portabilité (ou presque) sur toutes les machines disposant d’un compi- 
lateur C, facilité d’apprentissage vu le nombre réduit d'instructions, effica- 
cité dans la rapidité d’exécution des programmes produits, le C a encore de 
beaux jours devant lui. Le 520 ST devrait d’ailleurs participer à sa promo- 
tion puisque deux compilateurs existent déjà (deux autres annoncés) et le succès 
du GEM, écrit en C et donc particulièrement conçu pour une programma- 
tion en ce langage, ‘saura encore en accroître l'intérêt. 


Chaque médaille ayant son revers, le C a ses faiblesses : entre autres, 
sa lenteur de compilation et son manque d’analyse syntaxique. Ces défauts 
peuvent toutefois être minimisés par l’utilisation d’un disque virtuel (voir 
chapitre 3) et d’un programme de « lint ». 


2.1 Le langage C 


L'auteur n’a pas la prétention de croire que la lecture de ce chapitre 
dévoilera toutes les richesses du C, mais espère simplement que la présenta- 
tion rapide de ce langage permettra aux lecteurs débutants de s’en faire une 
première idée, et aux programmeurs plus avancés de disposer d’un aide- 
mémoire toujours disponible. 


2.1.1. Premier programme 


Il ne saurait être question de se soustraire à la tradition qui consiste à 
présenter le programme capable d’afficher à l’écran le célèbre « COUCOU ». 


4x Fremier programme */ 
main ()} 
int i, 

printf ("COUCOU"); 

for (i = 0; 4 € 32000: i++) ; 
4 


La première ligne de ce programme est un commentaire, équivalent au 
REM du Basic. Toute chaîne encadrée par le symbole d’entrée /+ et de sor- 
tie +/ est ignorée par le compilateur. 


La deuxième ligne main ( correspond au titre de la fonction. Un pro- 
gramme C est constitué d’un nombre variable de sous-programmes (nom- 
més fonctions en C) reconnus par un titre (un identificateur), permettant de 
les identifier. Un titre (ici main) est suivi de parenthèses ouvrante et fermante 
qui encadrent les valeurs (on parle d'arguments) que va recevoir la fonction. 
Même quand celle-ci ne reçoit pas d’argument (c’est le cas ici}, les parenthè- 
ses demeurent obligatoires. 


Le programmeur est libre de donner à une fonction le titre qu’il désire 
(en respectant cependant quelques règles) mais un programme doit toujours 
comprendre une fonction (et une seule) s’intitulant main. Ce titre indique 
au compilateur le point d’entrée du programme, c’est-à-dire la première fonc- 
tion à exécuter. 


Le « corps » d’une fonction (l’ensemble des instructions exécutées par 
une fonction particulière) est délimitée par une accolade ouvrante qui en pré- 
cise le commencement, et fermante pour stipuler la clôture de la fonction. 


La troisième ligne int i ; consiste en une déclaration de la variable « i » 
utilisée dans le programme. Le C a besoin de « reconnaître » tous les objets 
qu’il utilise. Voir chapitre 2.1.4. 


La quatrième ligne printf (« COUCOU ») n’est pas réellement une ins- 
truction C, ce langage ne disposant en effet d’aucune entrée-sortie, C’est un 
appel à une fonction qui appartient à la bibliothèque C standard, à qui l’on 
fournit comme argument une chaîne de caractères. 


Lors de l’édition de liens, cette fonction sera reconnue et transformée 
en une routine adéquate. La connaissance des fonctions appartenant aux 
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bibliothèques est primordiale afin de supplanter les manques du C en ce qui 
concerne la gestion des périphériques et de faciliter le travail de programma- | 
tion en évitant d'écrire ce qui existe déjà. 


La dernière ligne enfin est une véritable instruction qui bouclera 32 000 
fois permettant la temporisation d’affichage. 


2.1.2. Les identificateurs 


Un identificateur est un nom générique qui permet d’identifier les dif- 
férents objets manipulés par C, comme les fonctions, les variables, les 
constantes, etc... Ces identificateurs obéissent à quelques règles syntaxiques 
qu’il ne faut pas transgresser : 


— Ün nom peut être composé d’un nombre quelconque de caractères pris | 
parmi les lettres et les chiffres, le premier caractère étant obligatoirement | 
une lettre, Mais il ne peut comprendre ni espaces, ni caractères spéciaux à | 
l’exception du caractère de soulignement (_). 

— Seuls les sept premiers caractères de l’identificateur sont pris en compte 

par le compilateur de Digital Research. 

— Majuscules et minuscules sont permises, mais ne sont pas équivalentes, 

En C, la règle générale veut que l’on utilise les majuscules pour désigner les 

constantes, les minuscules étant réservées pour les titres de fonctions et de 

variables. 


val_tab dia TRUC +onc_i fonction 
sont des identificateurs corrects mais 


4500 Hieme fonc 1 test:5 
ne sont pas valides, 


2.1.3. Les constantes 


Les règles syntaxiques à utiliser pour spécifier les types de constantes 
sont les suivantes : . 


— en décimal, notation habituelle : 10 250 1300 

— en hexadécimal, le chiffre O suivi de la lettre x, ou X :  Oxlfff 
— en octal, précédé du chiffre O0: 014 0426 

— un réel: 3,125 1.023e+1 

— un caractère est placé entre apostrophes : ‘A’ ‘#7 ‘4 

— une chaîne est placée entre guillemets :  “‘ceci est une chaîne”. 


On peut augmenter la taille d’une constante entière en faisant suivre sa 
valeur de la lettre L indiquant ainsi une valeur longue : Ox1L. 


2.1.4. Déclarations et classes d'allocation 


Une variable est caractérisée par son identificateur (le nom de la varia- 
ble), son type (sa taille) et sa classe d'allocation (son espace mémoire). 


Les types : Il existe cing types usuels : 


« le type char (type caractère : 8 bits) 

« Je type int (entier machine, soit 16 bits pour le 68000) 

«* le type long (un long mot : 32 bits) 

+ le type float (flottant en simple précision : 32 bits) 

+ le type double (flottant en double précision : 64 bits. N’est pas implémenté 
sur tous les compilateurs). 


La déclaration des variables est obligatoire et doit toujours être termi- 
née par un point-virgule. Le chaînage des déclarations sur une même ligne 
est possible lorsqu'elles référent à un type identique ; de même qu’il est per- 
mis d’initialiser une variable lors de sa déclaration. 


int x, y,Z; /x déclare trois entiers */ 
long. val ; /x déclare une variable de type long */ 
char carac = ‘A’; /x déclaration et initialisation */ 


Le qualificatif unsigned associé aux types permet de considérer une varia- 
ble comme une valeur non signée : 


char c; /« valeur de c comprise entre — 128 et + 127 x/ 
unsigned char c ; /x valeur comprise entre 0 et 225 «/ 


La classe d'allocation : Une variable peut être stockée sous différentes 
formes dans la mémoire (dans la pile, un registre ou une cellule de mémoire 
permanente). La classe d’allocation spécifie, implicitement ou explicitement, 
l'emplacement qui lui est alloué. 


Les variables déclarées dans le corps d’une fonction (c'est-à-dire après 
l’accolade ouvrante) sont locales à la fonction et cessent d’exister dès que 
le programme en sort. Leurs contenus sont perdus. Cela permet de définir 
des variables qui occuperont la mémoire uniquement lors de leur utilisation 
et de ne provoquer aucun interférence avec d’autres variables locales qui 
emploieraient un même identificateur, 


Il peut cependant s’avérer nécessaire que le contenu d’une variable locale 
ne soit pas abandonné entre deux appels à cette fonction. Le mot réservé 
static indique au compilateur de préserver un contenu. 
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fonction ( 


{ : : 
int i} /* contenu perdu à chaque sortie de fonction 


static long compteur; + le dernier contenu sera préservé 


instruction ; 
> 


Les variables déclarées en dehors de toutes fonctions (elles sont généra- 
lement déclarées au début du fichier source) sont considérées comme globa- 
les et sont reconnues par toutes les fonctions du programme. Utiliser, pour 
ces variables, un même identificateur provoquerait un message d'erreur du 
compilateur. 


Lorsque une fonction où l'ensemble d’un programme doit utiliser une 
variable globale définie dans un autre fichier source, il lui faut spécifier que 
Ja variable à employer existe déjà ailleurs. On utilise alors le mot réservé extern. 


int coord.x! /£ variable globale interne #/ 

extern int sauve; J* variable globale externe au fichier */ 
oain {) 

{ 

Ent i, 5; {Y variables locales à la fonction #/ 
instruction; 


à 


Quand une variable locale doit être fréquemment utilisée (dans une boucle 
par exemple), la placer dans un registre représentera un gain de rapidité impor- 
tant (cf. chap. 1.3.). Le spécificateur register demande au compilateur (si 
c'est possible) le positionnement de la variable spécifié dans un registre, 


register int i ; /+ place la variable i dans un registre #/ 


2.1.5. Les opérateurs 


Le langage C propose un jeu complet d'opérateurs. Au-delà des « clas- 
siques » que l’on retrouve dans de nombreux langages évolués, les opéra- 
teurs de manipulation de bits permettent une programmation jusque-là dévolue 
à l’assembleur. 


Les opérateurs arithmétiques : 
+ addition 
_ soustraction 


* multiplication 
/ division 
% reste de la division (utilisable uniquement avec des entiers). 


L'opérateur d'affectation : 
L'opérateur “=”? charge une valeur ou le résultat d’une expression placé 
à droite de l’opérateur dans une variable située à sa gauche. 
Ex : val = 10 x=ax3+b res 1 = (z + d) 2 
Il est permis d’enchaîner les affectations. 
Ex:a=b=-c=-d#=0 annule les 4 variables a, b, c, d 
Lorsqu'un opérateur se retrouve de part et d'autre du signe ‘‘=??, il est 
possible de simplifier l'écriture. 
Ex:a=a+boux= x « 2 peuvent s’écrire a += b;x+= 23 


Seuls les opérateurs arithmétiques ou de manipulation de bits permet- 
tent ce genre d’écriture. 


Les opérateurs de manipulation de bits : 
Ces opérateurs ne peuvent s'appliquer aux variables de type flottant. 


. & ETlogique[0et0 —0,0et1 —0,1et1—1] 
! OÙ logique inclusif. [ 0 et 0 — 0, 0 et 1 — 1,1eti 1] 
+ OÙ logique exclusif, [ 0 et O — 0, 1 et 1—0,0et1—+1] 
>> Décalage à droite du nombre de bits spécifiés. 
Ex:z=72>>2(ouz >>= 2) décale z de2 bits vers la droite. Les 
bits sortants sont perdus : Îes bits entrants ont la valeur du bit de 
signe si la variable est signée, à 0 si unsigned 
<< Décalage à gauche du nombre de bits spécifiés, 
Ex. v = x << 4 les bits entrants sont mis à O. 
— Opérateur unaire de complémentation à 1. [ 0 > 1, 1 — 0] 


Les opérateurs d’incrément et de décrément : 


Les opérateurs + + et — — provoquent respectivement une incrémen- 
tation ou décrémentation de la variable qui leur est associée. 


Ex:i++,i-— ajoute ou retranche une unité à la variable i. 


Ces opérateurs peuvent être placés en préfixe pour que la valeur de la 
variable soit transformée avant son utilisation. 


Ex:siy=3, x=yY++ x = 3 puis incrément de y : y = 4 
x= ++y — incrément de y, puis affectation : x et y = 4 
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Bien que ces opérateurs fassent triple emploi (+ + équivalent à i = i 
+ 1, équivalent à i += 1), leur utilisation est vivement conseillée : le com- 
pilateur les optimise au mieux. 


Les opérateurs de comparaison : 


Ces opérateurs comparent deux expressions et donnent un résultat VRAI 
(non nul), ou FAUX (== 0). 


< inférieur 
<= inférieur ou égal 
> supérieur 
>= supérieur ou égal 


= identique (à ne pas confondre avec l’opérateur ‘=°?) 
l= différent 


Ex:x=a>b; xest non nulsia > b, égalàOsia <= 1. 


Les opérateurs logiques : 

Une opération logique est effectuée et donne un résultat VRAI (non nul) 
ou FAUX (== 0). 

&& ET logique : résultat vrai si toutes les expressions vraies. 
Ex: res = ((a != b) && (a < c) && (c == e)) 

À OÙ logique : résultat vrai si au moins une expression vraie. 
Ex : val = (x > y) (x > 2)) 

! NÉGATION unaire : un opérande VRAI devient FAUX, et 

réciproquement, 

Ex:x=ly xest VRAI si y est FAUX, FAUX si y est VRAI. 


Les opérateurs d’adressage : 


Ces opérateurs permettent d’accéder aux objets selon différentes métho- 
des qui seront explicitées dans les chapitres les concernant. 


fi Permet l’adressage indexé 

& Donne l'adresse d’un objet (le contexte le différenciant de l'opérateur 
logique de bit) 

+ Fournit le contenu d’une adresse (même remarque que précédemment 
pour l'opérateur de multiplication) 

— > Permet l’accès aux membres d’une structure par une adresse 

s (point) Permet l’accès aux membres d’une structure par une variable 


Les divers : 


L'opérateur sizeof fournit la taille en octets de l’opérande ou du type 
de base (char, int, etc...) qui lui est associé, 


Ex : sizeof (nom d’un tableau de 20 entiers) donnera 40. 
sizeof (int) sera égal à 2 (pour un micro 16 bits), 


L'opérateur ternaire ?: est fréquemment rencontré parce que per- 
mettant, avec concision, d’opérer un choïx entre. deux alternatives. [1 met 
en relation trois opérandes sous la forme suivante : 

(expression vraie) ? alors expression 1 : sinon expression 2 


Ex: x = (a >b)?a:b) affecte à x le contenu de la plus grande des 
deux variables 


Priorité des opérateurs : 


Le tableau ci-dessous résume l’ordre de priorité des opérateurs. Cette 
table est classée par ordre décroissant, les opérateurs ayant la précédence équi- 
valente étant placés sur une même ligne. Lors de l’écriture d’un programme, 
n’hésitez pas à employer les parenthèses si vous voulez être certain de la priorité 
à accorder aux opérateurs. 


H —— (type)  * & sizeof 
# (mul) 4 

gp = 

<< >> 

< = D >= 

= = 

& {ET binaire) 


E 


En 


RE etc... 


2.1.6. Les instructions 


Le C prouve, par l’exemple, qu’un nombre restreint d’instructions 
n’empêche pas la puissance d’un langage. Ces instructions ont été classées 
en deux groupes : 


— les instructions simples, 
— les instructions composées. 


Si ce classement n’est évidemment pas le seul possible, il va nous per- 
mettre d’énoncer quelques règles simples qui deviendront autant de moyens 
mnémotechniques susceptibles d’éviter certaines erreurs au débutant. 
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Les instructions simples 
Est simple l’instruction qui se suffit à elle-même, par opposition à l’ins- 


tuction composée qui est suivie, elle, d’une ou plusieurs instructions sim- 
ples. Une instruction simple est toujours terminée par un point virgule. 


+ L'instruction d’appel 


Pour clarifier l’ensemble d’un programme, il est toujours préférable 
d'écrire un grand nombre de fonctions élémentaires plutôt que quelques fonc- 
tions de taille importante. L’instruction d’appel de fonctions est donc fré- 
quemment rencontrée. 


Elle s’écrit sous la forme : 
som (argument 1, argument 2, .… argument n) ; 


où « nom » est l’identificateur (le titre) de la fonction, suivi, s’il en 
est besoin, de la liste d’arguments à fournir à la fonction appelée. 


Les arguments envoyés lors de l’appel d’une fonction sont des variables 
locales, inconnues de la fonction appelée. 


La fonction appelée doit donc déclarer les arguments reçus pour pou- 
voir les utiliser et travaillera sur les variables provisoires qu’elle s’est créées. 
Les variables de la fonction appelante ne seront pas modifiées. (Nous ver- 
sons plus loin qu’il est possible de fournir comme argument l’adresse d’une 
variable permettant ainsi d’en modifier la valeur). 


La déclaration des arguments s’effectue entre l’identificateur et le corps 
de la fonction. 


œia() 2% le point d'entrée du programme +/ 
T 


céclieration des variables locales; 

seruction 1; 

Iastruction 2; 

ES €a.b.c}; /* appel de fanctian avec 3 arguments #/ 


ete 0; 2% appelle la fonction sans arguments  */ 

2 dt fin du orogramme et retour +/ 

ei Cry-2) /4 l'instruction reçoit les valeurs des arguments */ 
Séciaretion de 4.y,23 /* déclaration des arguments */ 
Li 


ÉéSaration; /+ déclaration des variables locales à la fanction */ 


isrustion 2; 

3 44 retour à la fonction annelante +/ 
2 0 #4 la fonction ne recoit pas d’aroument Ÿÿ/ 
LA 

Sécieration; 


2sirection |; 
Ésrertion 2; 
5 


3 /* retour à 14 fonctian aopelante +7 


+ L'instruction d'affectation , 


Cette instruction utilise l'opérateur ‘=? pour affecter le résultat d’une 
expression à une variable. L’instruction s’évalue de droite à gauche. 


variable = expression ; 


ou expression peut être : 
— une constante 

a=b=0; /x annule les variables a et b +/ 

code = “A”: /x charge dans « code » la valeur ASCII de À (65) x/ 
— une autre variable 

val 1 = val 2; 
— une expression arithmétique, logique ou booléenne 

res =a+b+33; majus = minus & OXDF; plus gr = (a > b); 
— une valeur renvoyée par une fonction 

ret = trucO; /» la fonction « truc » retourne une valeur qui est placée 

dans la variable «/ 


Les incrémentations et décrémentations, qui sous-entendent l’opérateur 
“9 (i = i + 1), peuvent être également considérées comme des instruc- 
tions d’affectation. 


Ex:i++; is ++iù 3 


« L'instruction RETURN 


L’accolade fermante qui termine le corps d’une fonction est toujours 
traduite par le compilateur comme un retour au programme appelant (RTS 
en 68000). L’instruction return a les mêmes effets mais est employé dans les 
deux cas suivants : j 


— à la suite d’un test, le retour à la fonction appelante doit s’opérer 
avant la fin de la fonction, 
— Ja fonction appelante réclame une valeur en retour. 


return (résultat d’une expression) ; 


où expression peut-être d’un type complexe (arithmétique, booléen, 
etc...), mais représentant une unique valeur de retour. 


déclarations des variables globales; 
main () 

{ 

déclaration des variables lacalps; 


fnstruction 1; 
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fait 0: 
resul = teste 0j 4 dans "resul", 


valeur retournée par la fonction #/ 
fait O0 
géclaration des variables locales; 


struction Î; 
condition) return 0j /X si conditi 


instruction 2; 
> /# sinon retour en fin de fanction L74 


on remplie, retour immédiat */ 


tsste 0 
Le 
esclaration des variables locales; 


sastruction i; 
tcanditian) return(0); /* si condition remplie, retaurne Ô */ 
/à sinon retourne Un résultat algèbrique #/ 


return tatb+e); 
3 

Par défaut, une fonction retourne une valeur entière. Si tel n’est pas 
le cas, elle doit être déclarée en spécifiant le type de la valeur qu’elle renvoie. 
Le type retourné précéde l’identificateur de fonction lorsque la fonction est 
interne, sinon la déclaration est explicite. 


Sicat val_abs (x) 4% fonction retournant un +iottant #/ 
Sicat #5 4% déclaration de l'argument recu #/ 


Ficsi v} 
dost febs O3 /* déclaration de la fanction externe appartenant 
à la bibliothèaue C retournant une valeur absolue #/ 


y = és (3 JV valeur absolue de x */ 
reborn (y); 14 retourne un flottant #/ 
3 


+ L'instruction BREAK. L'instruction CONTINUE 

Ces deux instructions, placées à l'intérieur d’une boucle, sont géné- 
ralement associées à un test de condition. L’instruction break oblige un pro- 
gramme à sortir d’une boucle. L’instruction continue force la réitération 
immédiate d’une boucle. 


Nous en verrons des exemples concrets lorsque nous aborderons les ins- 
ævctions de bouclage. Cependant, un exemple littéral pourrait se présenter 


comme suit. 


Lire 100 caractères d’un fichier. 
Tam que « compteur » inférieur à 101 
< début de boucle > 
Hi caractère suivant et incrémente le compteur ; 
si une touche clavier est pressée break ; /+ sort de la boucle +/ 


si le caractère lu n’est pas une lettre minuscule continue ; 
/x retour à la première instruction de la boucle x/ 


sinon transforme minuscule en majuscule ; 
< fin de boucle > 


+ L'instruction GOTO 


Citons pour être complet l'instruction goto, bien que son emploi soit 
très déconseillé et puisse vous conduire au « plantage » (un saut intempestif 
risquant de faire perdre au programme son adresse de retour). 


goto étiqueite ; 
étiquette : instruction ; 


Les instructions composées 


Les instructions composées regroupent les instructions conditionnelles, 
de bouclage et d’aiguillage. Elles ont pour particularité d’être suivies d’une 
ou plusieurs instructions simples, la syntaxe étant différente selon le cas : 


— Une unique instruction suit l'instruction composée. 


Le texte est alors écrit en ligne, sans autre ponctuation que le ; 
terminateur. 


if(a>b)i++; 


Une instruction composée peut n’être suivie que d’une instruction vide. 
if(a==b); /xsia identique à b, ne rien faire #/ 
while (1) ; /x tant que 1 vrai, ne rien faire : boucle sans fin */ 


_ Une instruction composée entraîne l'exécution de plusieurs 
instructions. 


La suite d’instructions est alors encadrée par une accolade ouvrante et 
fermante pour constituer un « bloc ». Le juste positionnement de ces acco- 
lades est d'une importance extrême et demande une particulière attention lors- 
que des « blocs » s’imbriquent. Pour faciliter la compréhension et éviter les 
erreurs, il est utile d’indenter les lignes du programme. 


Âf (ab) € 

if tarot 
instruction 15 /* exécutés seulement si  +/ 
instruction 25 /# ab et ape +/ 
? 

else { 
instruction 3; /* exécutés seulement si  %/ 
instruction 43 /X a db et a <=c L 74 


à 
else instruction 53 /4 exécuté seulement si à <= D #/ 
instruction 6; 44 exécuté dans tous les cas *#/ 
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+ L'instruction IF-ELSE 
Certainement la plus connue des instructions conditionnelles, elle se pré- 
sente sous la forme : 


i£ (expression) instruction ; OU (bloc d'instructions) 
et facultativement 
aise instruction ; ou (bloc d'instructions) 


ou expression s’entendant au sens large du terme, est évalué. Son résultat 
VRAI (valeur différente de 0) ou FAUX (égal à 0) détermine les instructions 
à exécuter. 

Lorsque plusieurs if sont imbriqués, le else éventuellement rencontré peut 
se révéler ambigu. La règle suivante est alors adoptée : tout else s'associe 
an dernier if sans else qui le précède, lutilisation d’accolades pouvant bien 
entendu modifier ces concordances. 


val) it+; if (val) it+s 
d'aff) x = Yi if Caff) x = y; 
2 printf ("COUCOU"); 


3 
else printf {"CQUCQU") 3 


Dans le cas de gauche, la chaîne de caractère sera affichée si laff est 
‘ FAUX (siaffl= 0) ; dans le cas de droite elle sera affichée si val est FAUX 
== 0). 


= L'instruction WHILE et DO-WHILE 


Cette instruction génère une boucle, exécutée tant que le résultat d’une 
expression est VRAI. 


aile (expression) instruction ; Ou (bloc d'instructions) 


1x la fonction fonc.i retourne une valeur oui est placée 
3 la variable c. Tant qua € = 0, la boucie est ptécutée */ 


/X début de boucle */ 

£ (condition) continue; /* réiteration immédiate / 
struction fi 

sndition) break; LE] 
5 2 fin de boucle #/ 


, sort de la boucle &/ 


ui 
Le 


L’instruction do-while est utilisée lorsque l’on désire que la condition 
Es rebouclage soit testée en fin de boucle, ce qui signifie que les instructions 
€ le boucle seront exécutées au moins une fois. 
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do € 


instruction ji; 
instruction 2; 
> while (expression); /k si VRAI rebranchement à instruction 1 #/ 


+ L'instruction FOR 


Instruction très proche du FOR...TO...STEP du Basic, elle se présente 
sous la forme : . 


for (initialisation ; expression ; affectation) 
instruction ; ou {bloc d'instruction] 


L’initialisation n’est effectuée qu’au départ de la boucle, tandis qu’à 
chaque passage un test de l'expression est réalisé, entraînant, s’il est VRAI, 
une nouvelle affectation et un rebouclage. 


for (i=0 ;i < 100 ; i+ +) instruction :  /x exécutée 100 fois +7 
Les 3 composantes d’un for peuvent être multiples ou inexistantes : 
for (x < 50:x = y#2,j-) {bloc d'instructions] 


Ici il n°y a pas d’initialisation, alors que 2 affectations (séparées par une 
virgule) sont effectuées. 


* L'instruction SWITCH-CASE-DEFAULT 


Cette instruction d’aiguillage a pour plus proche équivalent Basic le 
ON...GOSUB, bien qu’en C un branchement ne soit en rien obligatoire : 
elle pourrait se traduire autrement par SELON...FAIT. 


switch texpression) € 
case valeur {: instruction 1; 
case valeur 2: instruction 2; 


default + instruction 3; 
x 


Le déroulement des instructions débute là ou existe une correspondance 
entre le résultat de l'expression et la valeur (obligatoirement une constante 
numérique ou symbolique). L’instruction qui suit default (facultatif), sera 
la seule exécutée si aucun case n’est applicable. Les instructions break et return 
permettent de sortir du switch. 


Il faut bien comprendre que, lorsqu’un case est sélectionné, toutes les 
instructions suivantes sont exécutées jusqu’à la rencontre d’un ordre de sor- 
tie du switch. Dans l’exemple qui suit, le break: du case “y? est obligatoire 
si l’on ne veut pas voir s’afficher la chaîne de caractères derrière default. 
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shitch (carac){ 


case ’a’:printf ("Puisque première lettre de l'alphabet, ")3 
case 6e’: 
case ?i?: 
case ?o0?: 
case ’u’: 
case *y’: printf (‘c'est une voyelle, \n“); 
breaks /x quitte Le switch */ 
default : printf ("Ce n’est pas une voyelle minuscule, \n"); 
à 


2.1.7. Directives de compilation 


Les directives s'adressent au pré-Processeur CP68 et pour cette raison 
sont précédées du symbole #. Elles permettent : 


__ une substitution symbolique : le mot réservé define permet de remplacer 
une chaîne ASCII par celle qui la suit. Les deux chaînes doivent être sépa- 
réss par un minimum d’un espace. La phase de compilation n'ayant pas encore 
éutée, tout est permis : 


VRAI À 
TANTOUE while 
ine MAXUXSY) COX) > (y) ? tx) + (Y)) 


— le chargement d’un autre fichier source : include placé en tête de pro- 
gemme chargera le nom du fichier mis entre guillemets. L'utilisation la plus 
Æéquente consiste à charger un fichier .H, contenant une liste de substitu- 
æans symboliques pré-existantes. 


*gendefs.h" 
“osbind,h" 


Nous ne saurions trop vous conseiller d'étudier les fichiers H fournis avec 
+ore compilateur : ils sont souvent riches d’enseignement. 


Un autre mot clef du langage C, typedef, permet de définir des types 
sonymes. Ce mot n’est pas interprété par le pré-processeur mais par le com- 
eur. Il est néanmoins proche de défine, permettant d'employer un nom 
plutôt qu’un type de variable. 


ispedef int entier ; 
zæë synonymes les déclarations : int truc; et entier truc ; 


2.1.8. Les tableaux 


Un tableau est une suite d'objets consécutifs et de même type, consti- 
tuant un ensemble fini (équivalent du DIM en BASIC). 
Comme tout objet manipulé par C, un tableau se déclare en précisant 


son identificateur, le type et le nombre des éléments qui le constituent. 
int val[10] ; extern float dec{50] ; 


La valeur entre crochets représente le nombre d'éléments du tableau et 
non la valeur du dernier indice comme en BASIC. Les indices de tableaux 
commençant toujours à zéro, le tableau val de l’exemple précédent permet 
de référencer 10 entiers indicés de 0 à 9. 


L'accession aux valeurs des tableaux s'effectue en précisant la valeur 
d'indice : 
val[3] représente le quatrième entier stocké dans le tableau val. 


Peu importe d’ailleurs le type d’élément du tableau, le compilateur s’occu- 
pant de la correspondance entre l'indexation et l'élément spécifié. 


int x3 
float y; 


x = val[13; /* place dans x les 2iène et Sième octets par rapport 
à l’origine du tableau val */ 
y = deccil;  /* place dans y du Sième au Bième octets relativement 
à l’origine du tableau dec */ 


Une chaîne de caractères est elle aussi stockée dans un tableau, le der- 
nier élément de celui-ci étant la valeur nulle (0) qui permet aux fonctions de 
détecter la fin de la chaîne. Un tableau de caractères comporte donc tou- 
jours un élément de plus que la longueur de la chaîne. Lors des initialisa- 
tions, le compilateur place automatiquement cette valeur nulle. 


char chaîne[]= " COUCOU " ; /x* place les 6 caractères de l’indice O 
à l'indice 5, et chaînel6]= 0 x/ 


Vous pouvez cependant faire confiance au compilateur pour compter 
Le nombre de caractères et gérer le tableau en conséquence. 


char voyellel]= ‘‘AEIOUY” ; /+ crée un tableau de 7 éleménts */ 


Le langage C permet également l'utilisation de tableaux à plusieurs dimen- 
sions, que l’on initialise par une liste de valeurs entre accolades. 
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int tab C23[3J)= © 10,1,2), €S,4,5 3; 


rer = EabE1302]; /X var = 5 */ 


2.1.9. Les pointeurs 


Pour bien comprendre l'utilité des pointeurs de variables, il faut se sou- 
venir que nous n'avons vu jusqu'ici que des fonctions qui se transmettaient 
des arguments par valeur, c’est-à-dire des « photocopies » de variables qui 
n'influençaient nullement l'original. Cette méthode s’avère fort utile lors- 
axe l’on ne désire pas que la variable d’origine soit modifiée par la fonction 
eppelée. Mais dans le cas contraire ? 


L'utilisation des pointeurs va nous permettre d’envoyer à une fonction 
Pedresse d’une variable afin que la fonction appelée puisse travailler direc- 
tement sur le contenu de l’adresse de la variable. C’est en fait ce qui se pro- 
du systématiquement en Basic : si une variable A est reconnue tout au long 
Sa même programme, c’est bien parce que l’interpréteur Basic travaille sur 
1: contenu d’une adresse. Le pointeur qui pose de nombreux problèmes au 
éfbwant en langage C, est paradoxalement, ce qu’il connaît le mieux. 


Si x est une variable, l’opérateur unaire & (à ne pas confondre avec l’opé- 
rateur & qui provoque un ET logique entre deux valeurs), permet de connaî- 
re l'adresse d’une variable. L'adresse de cette variable est ce que l’on nomme 
eæ C un pointeur. 


Ainsi, si l’on définit adr_val comme un long, écrire : 
adr val = &val; 


Sznifie que l’on place l'adresse de la variable val dans adr_val, adresse 
coimiant maintenant sur le contenu de la variable. 


I est possible de connaître l’adresse d’un tableau en demandant l’adresse 
&e son premier indice, ou plus simplement encore en ne considérant que l’iden- 
<cateur du tableau, ce dernier étant déjà une adresse. 


edr tab = &tab[0]; est équivalent à  adr_tab = tab ; 


E ae suffit pas d’avoir une adresse, encore faut-il pouvoir accéder à son 
cmmenu. L'opérateur unaire + est l'opérateur d’indirection spécifiant un 
cœmienu d’adresse. 


x = +adr _ val; /x x = contenu de l’adresse adr _ val #/ 


Puisque adr_val est l'adresse de val, x est maintenant égal à val. Par- 
tu l'expression +adr_val peut remplacer la variable val et se comporter 


azuement comme elle. 


*adr_val+ + ; sadr_val = 10; if (adr_val) … ; 


sont toutes des instructions valides. 


Un pointeur doit être déclaré pour signaler le type de la variable vers 
laquelle il pointe. 


+onc_1 O  /* titre Cou identificateur) de la fonction */ 
< 
int i =10; 


fonc_2 { &i )3 /* envois à la fanction l'adresse de À */ 
/X au retour, i= 11 *+/ 
n 


fanc_2 (pt) 

int #pt; /X déclaration de pt, adresse pointant sur un entier */ 
{ 

kptt++; /* incrémente le contenu de la variable, soit i */ 

} 


2.1.10. Les structures 


Une structure est un ensemble de variables, souvent de types différents, 
regroupées par un même identificateur pour en faciliter le traitement. Une 
structure simple, employée pour l’appel des fonctions GEM, constituera notre 
premier exemple. 


struct grect € 
int gs 
int g_y; 
int g_w; 
int g.h; 


Le mot réservé struct décrit une forme de structure, suivi de sa réfé- 
rence grect. Les quatre entiers qui constituent cette structure encadrés par 
des accolades, sont appelés les membres. 


La structure grect est maintenant définie comme un type, de la même 
manière que int ou char sont des types. Déclarer une variable : 


struct grect var ; 
désignera var comme une variable de type grect. 


Lorsque, dans une expression, on désire s’adresser à un membre de la 
structure, on utilise la syntaxe suivante : 


« variable de la structure » . «membre» Ex: coor_ x = var . gx; 
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L'opérateur « point » (.) met en relation la structure et son membre. 
Il est ainsi possible de s’adresser séparément à chaque membre de la struc- 
zure considérée pourtant comme un tout. La structure grect va pouvoir nous 
servir à définir quatre éléments nécessaires en GEM pour l’ouverture d’une 
Fenêtre, d’un dialogue, etc. Les quatre membres désigneront respectivement 
les coordonnées X et Y d’un rectangle, sa largeur et sa hauteur. 


Un autre opérateur permet de s’adresser à un membre particulier d’une 
sructure, s'appliquant cette fois à un pointeur de structure. Si l’on déclare 
un pointeur de structure : 


sruct grect «p_rec; /* p_rec est une adresse pointant sur grect #/ 


e pointeur » —> « membre» Ex: coor x = p_rec->£ x; 


Cette instruction donnera le même résultat que précédemment et affec- 
te à la variable coor_x la valeur du membre g_x. 


L’intérêt des structures est encore plus évident lorsque les membres sont 
és variables de types différents. L'exemple classique consiste à présenter 
ces structure capable de stocker les caractéristiques d’un individu. Cette struc- 
re pourrait comprendre un nom (une chaîne de caractères), un numéro de 
t&äphone (un long), et le sexe (1 ou 2 dans une variable char). 


sSrect pers { 
cher noa[20); 
long tel; 
char sexe; 
3 individu, Xpt_ind; 


Les deux identificateurs qui suivent l’accolade fermante déclarent immé- 
srement une variable et un pointeur de type struct pers et remplace la décla- 
redon: struct pers individu, «pt_ind ; 


Là encore, les opérateurs d’adressage ‘‘.” et ‘->?? permettront de 
s'adresser directement aux membres de cette structure. 


2.2. Les bibliothèques C 


2.2.1. La bibliothèque standard 


Les fonctions de la bibliothèque standard que supporte le compilateur 
&2 Digital Research sont détaillées dans l’annexe 1 et nous vous invitons à 
vous y reporter avant de continuer plus avant la lecture de cet ouvrage : il 
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est important en effet d’avoir une idée globale de ce que peut apporter cette 
bibliothèque. Sa connaissance, même succinte, saura vous éviter la résolu- 
tion, inutile puisque déjà prévue, de problèmes spécifiques. 


Le lecteur voudra bien excuser le manque de développement dans l’exposé 
de ces fonctions uniquement dû au souci d’expliciter plus longuement le GEM, 
bibliothèque récente et donc bien moins connue. Les ouvrages sur le C (cf 
bibliographie) apportent déjà de nombreux renseignements sur les fonctions 
de base du langage et les fournir une fois encore n’aurait été que redondance. 


2.2.2. La bibliothèque GEM 


VDI et AEËES forment les deux composantes de la bibliothèque GEM. 
Si les routines qui les constituent sont effectivement séparées en mémoire 
(cf chap. 1.2.), si même l’éditeur de liens les dissocie en leur affectant une 
librairie spécifique, il n’en demeure pas moins vrai que le programmeur peut 
les considérer comme un ensemble, 


Il est encore possible, en se privant de nombreuses facilités, d’écrire une 
application n’utilisant que le VDI. Mais ce n’est pas vrai pour l’AËS qui exige 
au minimum l’appel de la fonction VDI v_opnvwk ouvrant une station de 
travail virtuelle, Une application ne se fait donc ni en VDI, ni en AES mais 
bien en GEM. Si ces deux bibliothèques sont également utiles, elles n’en gar- 
dent pas moins leurs spécificités. 


L’AEBS est particulièrement orienté vers la gestion des fenêtres, de la souris 
et des interactions avec l'utilisateur et les autres applications. Pointue et évo- 
luée, une seule fonction AËS représente la plupart du temps l’équivalent de 
plusieurs appels VDI. à 


On est toujours le « pauvre » de quelqu’un et le VD], malgré ses gran- 
des capacités, paraît quelquefois terne au regard de la bibliothèque AES, sa 
voisine. Mais n’est pas toujours dépourvu celui qu’on croit et le VDI pallie 
bien souvent les manques d’un AES très spécifique. Il n’existe par exemple 
pas d'équivalent AES pour la sauvegarde ou la restitution de zones d’écran 
et utiliser les possibilités de l'éditeur alphanumérique interne au VDI peut 
parfois faire oublier les jolies glissades d’un ascenseur graphique. 


Les fonctions VDI 

Toutes les fonctions VDI implémentées sur le 520ST sont détaillées dans 
l’annexe 2, de nombreux renseignements sont également fournis dans le cha- 
pitre 3.3. relatif à la ligne “A”. Il ne sera expliqué ici que quelques règles 
relatives à l’appel en C. 
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Les tableaux des paramètres VDI, explicités en début d’annexe et dont 
le contenu est spécifié pour chaque fonction, doivent obligatoirement être 
déclarés comme variables globales en tête de votre fichier source. La capa- 
aité des différents tableaux doit au moins être égale aux nombres de para- 


mètres qu’envoie où que retourne la fonction du programme la plus 
« gourmande ». 


Si vous n’en êtes pas à économiser quelques octets de mémoire, vous 
pouvez décider de les dimensionner aux valeurs maximales suivantes, per- 
mettant sans restriction Pappel de toute fonction VDI : 


int control [1] ; /* 11 paramètres pOur les fonctions vectorisées #/ 
ini intin [80]; /* longueur de chaîne pour v_gtext #/ 

tnt ptsin [128] ; /x valeur maximale de points en entrée #/ 

fat intout [45]: /* 45 paramètres POUT y_opnvwk «/ 

mt ptsout [12] ; /x 12 paramètres POUT v_opnvwk #/ 


Lorsqu'une fonction fournit ou retourne comme paramètres des coor- 
gonnées de points, celles-ci s’évaluent T OUJOURS par rapport au coin supé- 
steur gauche de l'écran représentant le point 0x0. Les coordonnées du coin 
inférieur droit de l’écran sont dépendantes de la résolution choisie (639x399 
g haute résolution, 639x199 si moyenne, 319x199 si basse). Le GEM installé 
sur l'Atari ne permet pas en effet l'utilisation du système de coordonnées 
NDC, implémenté sur d’autres machines. 


A l'édition de liens, le fichier .0 obtenu après compilation doit être lié 
avec la librairie vdibind. 


Les fonctions AES 

La nomenclature en annexe 2 explicite les fonctions AËS en fournis- 
sant pour chacune d'elles le détail des paramètres nécessaires. En C, la con- 
cordance entre les identificateurs d'arguments et leurs localisations dans les 
shleaux internes du système ne sont d'aucune utilité. 


Les seules exigences consistent à appeler, avant toute autre, la fonction 
g'initialisation appl_init (appl_exit en fin d'application) et à lier le fichier 
compilé avec la librairie aesbind. 

Les pages suivantes donnent des précisions sur les principaux objets que 


manipule VAES et explicite l'agencement des fonctions AES pour certaines 
iêches déterminées. d 


Note : Les noms symboliques utilisés dans la définition des objets sont 
isdus dans le fichier « OBDEFS.H ». 


Création des ressources : 


La première action à envisager lorsque vous programmez en GEM con- 
siste à bâtir votre fichier de ressources. (Vous ne pourrez en effet tester votre 
programme sans avoir défini, pour le moins, les objets composant votre 
menu.) 


Les ressources définissent de façon structurée tous les objets qu’aura 
à utiliser une application particulière. Le mot « objet » a un sens très large 
en GEM et représente aussi bien des chaînes de caractères, des boîtes de dimen- 
sions variées contenant généralement d’autres objets, des zones rectangulai- 
res de tailles réduites incluant un texte court (des « boutons »), des icônes, 
des images, etc. 


Ces objets sont classés de façon particulière afin de préciser les relations 
qu’ils entretiennent entre eux et l’on nomme arbre une série d’obijets divers, 
étroitement dépendants les uns des autres. L'objet à la base de l'arbre repré- 
sente la racine, les « branches » constituant les enfants qui peuvent eux-mêmes 
être parents d’autres objets. 


Exemple : Une application nécessitant une barre de menu et une forme 
de dialogue nécessitera deux arbres. La racine du premier représentera la barre 
du menu, parent des titres du menu, eux-mêmes parents des items du menu 
qui leur correspondent. Le deuxième arbre aura comme racine un objet en 
forme de boîte, parent d’une chaîne de caractères et de deux boutons (‘OK’? 
et “‘ANNULER”?). 


Chaque objet est défini par une structure d’objet de 24 octets. 


STRUCTURE D'OBJET 


ob_tête 


ob_taille 


8 | ob_drap ob_état 
12 ob_spec 

16 ob_x ob_y 

20 ob lar ob haut 


ob_suit : l'index de l’objet suivant (—1 si racine, pointant vers son frère 


si pas d’enfant, pointant vers son parent si dernier enfant) 
ob tête : l'index du premier enfant de l’objet (—1 si pas d’enfant) 
ob_taille : l'index du dernier enfant de l'objet (—1 si pas d'enfant) 
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ob_type : un mot représentant le type de l’objet (voir plus loin) 

ob drap: un mot représentant le drapeau d’objet (voir plus loin) 
ob_état : un mot représentant l’état de l’objet. 

ob spec : un long mot dont le contenu dépend du type de l’objet 

ob x : coord. X de l’objet relativement à son parent (écran si racine) 
ob_y : coord. Y de l’objet relativement à son parent (écran si racine) 
ob larg : largeur de l’objet en pixels 

ob_haut : hauteur de l’objet en pixels 


Les valeurs de type (ob_type) représentant les objets usuellement employés 
sont les suivantes : 


+ 20 G BOX : boîte graphique (ob_spec= couleur et épaisseur de 
ligne) 

+21 G TEXT : texte graphique (ob spec= adresse de struct. 
TEDINFO) 


+22G BOXTEXT : une boîte graphique contenant du texte (ob_spec= 
adresse d’une structure TEDINFO) 
+25 G IBOX : une boîte graphique sans couleur de fond 
(ob_spec= couleur et épaisseur de ligne) 
=26 G BUTTON  : un bouton contenant du texte justifié 
(ob_spec= adresse de la chaîne texte terminée par 0) 
+27 G BOXCHAR : un bouton contenant un unique caractère 
(ob_spec= le caractère + couleur + épaisseur) 
+ 28 G STRING : texte graphique (ob_spec= adresse de la chaîne) 
= 29 G FTEXT : texte graphique formaté (ob spec= adresse 
TEDINFO) 
+ 30 G FBOXTEXT : une boîte contenant du texte formaté 
(ob_spec= adresse de structure TEDINFO) 
+ 31 G TITLE : chaîne utilisée pour les titres de menus 
(ob_spec= adresse de la chaîne) 


La valeur du drapeau ob_ drap indique à l’AES si le bit correspondant est 
Läs à 1 que: 


= 050000 NONE : signe particulier = néant 

« Gx0001 SELECTABLE : l'utilisateur peut sélectionner l’objet par cliquage 
— affichage en vidéo inverse 

z #x0002 DEFAULT : Pobjet de sortie si touche <RETURN> appuyé : 
un seul objet par arbre peut être défini ainsi 
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« 0x0004 EXIT : V'AES retourne le contrôle à application si Puti- 
lisateur a cliqué sur objet. 

* 0x0008 EDITABLE  : l’objet est éditable par l'utilisateur : spécifie un 
champ d’édition ù 

* 0x0010 RBUTTON : un groupe de boutons ne pouvant être sélection- 
nés en même temps : si l’un est sélectionné, les 
autres sont désélectionnés par l’AES. 

* 0x0020 LASTOB : Je dernier objet de larbre 

* 0x0040 TOUCHEXIT : l’AES retourne le contrôle à l’application si bou- 
ton de souris pressé et souris dans l’objet 


La valeur de ob_etat indique si le bit correspondant est mis que: 


+ 0x0000 NORMAL : affichage en vidéo normale 
# 0x0001 SELECTED  : affichage en vidéo inverse 
* 0x0002 CROSSED : une croix est tracée sur l’objet (si l’objet = boîte) 


* 0x0004 CHECKED : un « check » (VŸ est tracé près de l’objet 
+ 0x0008 DISABLED  : affichage en intensité réduite 

« 0x0010 OUTLINED  : l’objet est entouré d’une ligne 

* 0x0020 SHADOWED : « ombre » l’objet (dessine un relief) 


Nous avons vu que les objets de type G TEXT, G_BOXTEXT, 
G_FTEXT et G FBOXTEXT contenaient dans le long mot ob_spec une 
adresse de structure que GEM nomme TEDINFO. Cette structure de 28 octets 
définit un champ d'édition, c’est-à-dire un objet géré par l’AES qui laisse 
l'utilisateur entrer un texte au clavier selon un format et un espace de vali- 
dité définis dans la structure, 


Structure TEDINFO : 


Jun 
+ rm 


te res2 te_épais 


te_txtlg |te tmplg 


te _ptext : l’adresse de [a chaîne d’affichage actuel. Si 0 ou ‘“@°’ comme 
premier caractère, la chaîne n’est pas affichée. 
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te_ptmplt : l’adresse de la chaîne de formatage 
te pvalid : adresse de la chaîne de validité. Selon la valeur, autorise : 
= l'entrée de chiffres 
= l’entrée de lettres majuscules + <espace> 
= Jettres majus. et minus. + <espace> 
lettres majus. + chiffres + <espace> 
= lettres majus. et minus. +chiffres + <espace> 
= caractères valides de nom de fichier + (‘7 x : 7?) 
= tout caractère, converti en majuscule. 
ie_pol : police système utilisée : 3 = 8x8, 5 = 6x6 
ie resl: réservé 
ée just: type de justification de texte désirée 
0 = justifié à gauche 
1 = justifié à droite 
2 = centré 
&æ color : couleur et fond de l’objet 
æ res2 : réservé 
te épais : épaisseur de ligne de la boîte. 
se txtle : longueur de la chaîne pointée par te _ptext 
te implg : longueur de la chaîne pointée par te ptmplt 


XIE 28 > 0 
Il 


L'exemple suivant explicite la façon dont travaille l’AES pour gérer un 
champ d'édition selon les composants de la structure TEDINFO. 


— te_ptext pointe sur une chaîne vide 
— te_ptmplt pointe sur la chaîne “ .PRG”’ 
— te_pvalid pointe sur la chaîne ‘’ANNNNNNN” 


Quand l’ABS entrera dans le champ d’édition, il affichera la chaîne poin- 
te par te_ptmplt, placera le curseur et attendra comme premier caractère une 
Etre majuscule, les six caractères suivants pouvant être indifféremment chif- 
£res ou lettres majuscules (soit sept caractères, un de moins que la longueur 
de te _pvalid). 


L'AES gère son curseur ainsi que les touches <ESCAPE> et <BACKS- 
PACE>. Le contrôle est retourné à l’application lorsqu'une condition de 
sortie est réalisée (cliquage sur une TOUCHEXIT ou <RETURN> si un 
bouton de sortie est DEFAULT). 


Le fichier des ressources est créé à partir du programme RCS.PRG fourni 
avec certains compilateurs (Digital Research notamment). Cette application 
permet de construire les différentes structures (d’arbres, d'objets), et four- 
2 un fichier avec l’appendice “RSC”? qui peut être directement chargé par 
& fonction AES rsre_ load. 


ai 


Si vous avez spécifié un nom pour chaque objet créé (option ‘Name’? 
du menu), le fichier .H que vous fournira le programme RCS. contiendra 
les substitutions symboliques (# define). Inclure ce fichier dans votre source 
(par # include) vous permettra d’utiliser les noms symboliques chaque fois 
que vous devrez faire référence à un objet. 


Une fois chargé le fichier de ressources, en utilisant la fonction rsrc_gaddr 
votre application pourra : 


— avec les fonctions de gestion de menu : 
+ afficher la barre des menus 
+ modifier les caractéristiques des objets constituant l’arbre du menu (Ex : 
désactiver un item, placer un « check », etc...) 


— avec Jes fonctions de gestion d’objets : 


+ tracer un ou plusieurs objets 
« modifier l’état d’un objet, etc. 


— avec les fonctions de gestion de forme : 
« laisser l’'AES gérer une forme dialogue. 

Une forme dialogue est définie dans un arbre dont la racine est une boîte 
(type G_BOX) et les enfants, des boutons où un champ d'édition. Elle permet 
de solliciter l’utilisateur et d’en recevoir une réponse. 


Note : Une forme d’alerte n’est en fait qu’une chaîne « habillant » des 
objets (une boîte et 3 boutons) appartenant à l’AES. Elle ne fait donc pas 
partie des ressources. 


Lancement de l'application 

Lancer une application ABS signifie quitter le Bureau, se faire « recon- 
naître » par le programme maître de l’AES (SCREEN MANAGER) comme 
nouvelle application courante. C’est le rôle de la fonction appl_init qui 
retourne un identificateur AES dévolu à votre application tant que celle-ci 
est ouverte. 


Après avoir positionné la souris dans sa forme « abeille » par graf_mouse 
spécifiant à l'utilisateur un accès disque, votre application charge par la fonc- 
tion rsre_Joad le fichier des ressources, fichier qui devra être placé sur le 
même disque que votre programme. N'oubliez pas de prévoir un arrêt de 
l'application et l'affichage d’un message d’erreur au cas où le fichier ne pour- 
rait être chargé. Si tout s’est passé normalement, est retournée l’adresse de 
stockage de vos ressources. 


Un appel à la fonction VDI v_opnvwork initialise les paramètres VDI, 
ouvre la station virtuelle qu’utilisera votre application, et vous retourne un 
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certain nombre de renseignements. Beaucoup de ceux-ci ne sont utiles que 
pour assurer une portabilité entre les différentes machines tournant sous GEM, 
d’autres peuvent être indispensables. Ainsi, connaître la résolution d’écran 
sélectionnée par l'utilisateur (arg_out[0] et [1]) a souvent une extrême impor- 
tance pour la suite de votre application. La fonction vq_extend peut vous 
fournir des informations supplémentaires. 


L'application réserve par un TRAP 1 fonction $48 (Malloc) la place 
mémoire nécessaire au stockage de l'écran qu’elle aura à gérer. C'est en effet 
au programmeur qu’il incombe, sur ordre de l’AES, de retracer une zone 
spécifiée lorsqu'elle a été recouverte par la fenêtre d’un accessoire, une forme 
dialogue, ete. L'adresse retournée par Mailoc sera chargée dans le membre 
fd_addr de la structure MFDB destination (cf chap. 3.3. instr. A007). La 
MFDB source sera initialisée aux coordonnées d'écran (avec adresse = 
adresse mémoire écran). Chaque fois qu’il sera nécessaire, le contenu 
de l'écran sera préservé par l’appel de la fonction VDI vro_cpyfm. Il est 
ten entendu nécessaire de cacher la souris avant la sauvegarde et de la 
restituer une fois celle-ci effectuée. 

Par la fonction rsre_gaddr l’application demande l’adresse de Parbre 
é£finissant le menu. La fonction menu_bar affiche la barre des menus dans 
le haut de l’écran. 


L'application crée sa fenêtre. Elle appelle wind_update (1) pour éviter 
amie interférence avec les accessoires. Elle demande par la fonction wind_get 
Güsatificateur de fenêtre du Bureau = 0, drapeau = 4) la dimension maxi- 
zale que lui laisse le Bureau, c’est-à-dire la taille de l’écran moins la barre 
&es menus. Comprise dans les limites retournées, la fenêtre est créée par un 
zapel de wind_create en spécifiant les composantes de la bordure (case de 
£ameture, de dimensionnement, etc.…). Si la fenêtre a pu être créée, un iden- 
sificateur est retourné : si (— 1) prévoir une forme d’alerte. 


L'application peut maintenant ouvrir la fenêtre en appelant wind_open 
ex en précisant les dimensions souhaitées. Elle appelle wind_update (0) pour 
EÆloquer les accessoires, elle positionne la souris dans sa forme « flèche » 
gris se met en attente d'événements. 


L’atente d'événements : 

L'attente des événements est l’axe central de votre application : toute 
zion qu’éxécute celle-ci partira de cette fonction et y reviendra une fois 
Le têche exécutée pour attendre un nouvel événement. 


Vous devez écrire cette fonction comme une boucle sans fin, la seule 
pessibilité de sortie (par l'instruction break) devant être le message indiquant 
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que l'utilisateur désire sortir de l’application, soit en général l’option « Quit- 
ter » du menu. 


Le chapitre 4.3 explique en détail le fonctionnement du programme maître 
de 'AES (SCREEN MANAGER). Il suffit de dire ici qu’à chaque fois qu’une 
application est en attente d'événements, l’AES reprend le contrôle total du 
système et gère ses interruptions. Chaque interruption est présentée à TOUTE 
application en attente d'événements (c’est-à-dire à votre application et à cha- 
que accessoire chargé au démarrage du système). Il incombe au program- 
meur de faire le tri des événements qu’il reçoit. 


Une première sélection s'opère d’après l’evnt que vous avez choisi : si 
par exemple vous n’attendez pas d’événement d’horloge, VAES n’entrera pas 
dans votre boucle d’attente. 


Le second tri s’opère en testant, en même temps que l’événement, le con- 
tenu des variables reçues. L’AES spécifie par exemple que l'utilisateur a cli- 
qué dans la case de fermeture d’une fenêtre, il envoie également l’identifica- 
teur de la fenêtre à fermer : votre application devra tester ces deux valeurs 
avant d’entreprendre la moindre action. D'une manière générale, gardez tou- 
jours à l'esprit que votre application ne tourne pas seule, 


Que se passe-t-il lorsqu'une application et un accessoire attendent le même 
événement (un appui sur le bouton de souris par exemple) dont il est impos- 
sible de connaître le destinataire ? Dans ce cas, c’est le mieux placé sur la 
liste des programmes en attente (c’est-à-dire l'application ou l’accessoire dont 
la fenêtre est active) qui gère l'événement. Les différents événements que votre 
application peut attendre de l’AES sont explicités dans l’annexe 2. Ne sera 
notifié ici que la manière dont s’effectue le partage des tâches. 


L’AES gère seul tout ce qui concerne les bordures de fenêtres, la barre 
des menus et les menus eux-mêmes lorsqu'ils sont déroulés : dans ces zones, 
tout déplacement de la souris ou appui du bouton provoque une action spé- 
cifique que l’application ne contrôle pas (par exemple le déroulement des 
menus, la boîte en traits pointillés dessinée lors d’un déplacement de la fenê- 
tre ou de l’ascenseur, etc..). Au relâchement du bouton, l’AES envoie un 
message particulier dont la réception est assurée par evnt_mesag ou evnt_. 
multi. L'application, si elle le désire, engage l’action demandée. 


L'application a par contre le contrôle du reste de l'écran, c'est-à-dire 
la zone de travail de sa (ses) fenêtre(s) (fenêtre moins bordures) ainsi que 
la fenêtre de fond du Bureau (partie grisée sur laquelle viennent s’ouvrir les 
fenêtres) si celle-ci est encore apparente. 
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Gestion de dialogue : 


Un dialogue s’instaure entre l’application et Putilisateur chaque fois 
qu’une action exige une décision de ce dernier. 


L'application demande par rsre_gaddr l'adresse de l'arbre de dialogue que 
le programmeur a défini dans les ressources. Elle positionne les coordon- 
nées d’affichage de la boîte de dialogue (voir « calculatrice ») ou appelle sim- 
plement form _center qui retourne les coordonnées centrées par rapport à 
Pécran. | 


L'application appelle form_dial avec le drapeau à O réservant ainsi 
Pespace écran, dessine l'arbre par objc_draw, laisse l'AES gérer les interactions 
entre le dialogue et l'utilisateur par un appel à form_do. Lorsqu’un bouton 
qui a été défini comme EXIT ou TOUCHEXIT (voir drapeau d’objets) est 
sélectionné par cliquage (ou touche <RETURN> si un bouton est 
DEFAULT), l'AES retourne l'index d'objet qui a occasionné la sortie. 


L'application appelle form._dial avec le drapeau à 3 pour libérer l’espace 
écran, et teste : 


— soit uniquement le bouton de sortie 
— soit la chaîne contenue dans le champ d'édition s’il existe 
_— soit l’état des RBUTTON (voir les types d’objets) 


Après analyse, l'application désélectionne l’objet de sortie par 
obj_change, entreprend l’action demandée et retourne à la boucle d’attente 
d'événements où elle recevra un ordre de retraçage. 


Retraçage d'écran : 


L’AES a envoyé un message de retraçage qui vous est destiné, spéfi- 
ciant ainsi que la zone de travail dont votre application a la charge doit être 
remise à jour. Il vous fournit en même temps les coordonnées de la zone 
à retracer. Il est envisageable cependant que cette zone n’appartienne pas 
en totalité à votre application. L’intersection de cette zone et de votre fenê- 
ire peut même ne pas vous concerner totalement : si par exemple un acces- 
soire est positionné sur votre fenêtre, retracer l'intégralité de celle-ci recou- 
vrirait tout ou partie d’une zone dont vous n’aviez pas à vous soucier. 


Pour éviter ces interférences, l’AES tient à jour une liste de rectangles 
qui délimite les différents « propriétaires » de l'écran. C’est en appelant cette 
Bste que votre application pourra connaître sa zone effective de retraçage. 


L'application appelle d’abord la fonction wind_update (1) qui interdit 
route interférence, appelle ensuite wind_get avec la valeur du drapeau à 11 
ai retourne les coordonnées du premier rectangle de la liste. Peut alors com- 
mencer une boucle ayant la forme suivante : 
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| 
* 
De 


1) tant que coord. X et Y retournées différentes de 0 
2) s’il existe une intersection entre le rectangle retourné et la zone de travail 
de l'application alors : 
+ structure MFDB source = structure définissant la mémoire avec comme 
coordonnées la zone d’intersection à retracer. 
structure MFDB destination = écran (adresse = OxOL) avec les mêmes 
coordonnées que la source. 
+ appel de vro_cpyfm (voir VDI). 
3) appel de wind_get avec drapeau à 12. 
4) retour à 1), condition de boucle. 
5) fin de boucle : appel de wind_update (0). 


+ 


Sortie d’application : 


Lorsque la condition de sortie de l’application est réalisée, celle-ci sort 
de sa boucle d'attente d’événement, appelle la fonction de fermeture de fenêtre 
wind_close, la fonction de suppression de fenêtre wind_delete. L'application 
supprime la barre des menus (menu_bar avec le drapeau à 0), libère l’espace 
mémoire réservé pour l’écran par TRAP 1 fonction $49 (Mfree), ferme la 
station de travail virtuelle (vclsvwk), termine l’application par appl_exit. 


2.3. Exemple de programme 


Le programme dont le listing est fourni dans les pages suivantes consti- 
tue un exemple concret d'utilisation des fonctions GEM et, dans une moin- 
dre mesure, des fonctions de la bibliothèque standard. Son rôle n’est pas 
seulement didactique puisqu'il vous permettra de disposer d’une calculatrice 
dans les accessoires du Bureau. 


Il vous faut d’abord re-créer le fichier des ressources avec l'utilitaire 
RCS.PRG. Le listing en C des ressources vous aidera à rebâtir l'unique arbre 
qu’utilise l’accessoire. 


Cet arbre (une forme dialogue) est « père » de 20 « enfants »: 


— 19 boutons de type G_BUTTON (les dix chiffres de 0 à 9, les quatre opé- 
rateurs élémentaires, le point décimal, le signe “=”, un bouton “CE”, un 
bouton ‘CA’? et le bouton ‘“‘FIN’’ qui stoppe la calculatrice). 

— 1 champ d'édition de type G_FBOXTEXT, l'écran de la calcultratice. 


Tous les boutons sont des TOUCHEXIT, SELECTABLE, le bouton 
‘_ étant également DEFAULT. La chaîne de validité (te _pvalid) doit 
contenir exclusivement des ‘°X??. 
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un 


Vous donnerez à chaque objet de l’arbre (option ‘Name’ de RCS) le 
nom défini dans le fichier “CALCUL.H”’, mais il faut également que les 
10 index définissant les boutons de chiffres soient dans un ordre croissant 
a régulier. Selon la valeur d’index du bouton “0”? (dans le programme, elle 
est à ?), il vous faudra modifier dans la fonction gere_cal la ligne default : 
val = sortie + 47 ; qui ajoute une valeur à l’index d'objet pour retrouver 
les codes ASCII des chiffres 0 à 9. 


Une fois le fichier “CALCUL. RSC’ créé, vous pourrez en demander 
Le listing C pour vérifier qu’il correspond bien au modèle. Les différences 
entre les tailles des objets peuvent toutefois être comprises dans une certaine 
Fourchette. 


Après saisie et compilation, le liage du fichier ‘‘calcul.0”? que vous aurez 
obtenu s'effectuera avec la commande suivante : 


Hnk68 [tem[a où b :], u, s,] calcul.68k= accstart, osbind, calcul.0, aesbind, 
vdibind, gemlib, libf 


Le fichier ‘“‘calcul.68k*? sera ensuite rendu relogeable avec ‘‘relmod”. 


Le programme obtenu doit être placé sur la disquette système avec, 
comme appendice de nom de fichier, les trois lettres .ACC. Le fichier ‘‘Cal- 
calrsc”, ressources de l’accessoire, devra également être chargé sur la dis- 
œuette système. 


MODE D'EMPLOI : En cliquant sur l’item du menu “Calcul”, vous 
ouvrez l'accessoire, le déplacement de la fenêtre est alors valide, En cliquant 
sr la case “‘pleine fenêtre”, vous branchez la calculatrice : le message ‘ON?’ 
s'affiche dans le bouton interrupteur et le curseur est affiché. Clavier et sou- 
#s autorise l’entrée de caractères. Le bouton ‘CE’ efface le dernier chiffre 
entré, le bouton “CA”? efface l'intégralité de la chaîne. Tout caractère inva- 
Bäe sera refusé par l’application. Pour éteindre la calculatrice, il faut cli- 
que dans la touche ‘‘ON’” et cliquer sur la case de fermeture pour refermer 
Taccessoire. 


Cette calculatrice n’utilise que la simple précision (flottant), le type double 
n'étant pas implémenté sur le compilateur de Digital Research. Elle n’est 
&’auxre part pas prévue pour fonctionner en basse et moyenne résolution : 
fs gestion des modifications des tailles des ressources aurait en effet consi- 
€£reblement alourdi le programme. Mais il n’est pas interdit, bien au con- 
were, de l'améliorer. 
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FICHIER DES DÉFINITIONS ” 
#define CALCUL O  /X TREE */ ss 
#define ZERO 1 /*x OBJECT in TREE #0 */ 
#define UN 2 /X OBJECT in TREE #O */ Los 
#define DEUX 3 /*X OBJECT in TREE 40 */ 
#define TROIS 4 /*X OBJECT in TREE #0 */ 
#define QUATRE 5 /* OBJECT in TREE #0 */ Ë 
#dafine CINA 6 /% OBJECT in TREE 40 */ ! 
#define SIX 7 /Xx OBJECT in TREE #0 */ 
Hdefine SEPT 8 /* OBJECT in TREE #0 #/ 
#define HUIT 9 /X OBJECT in TREE #0 */ 
#define NEUF 10 /*x QBJECT in TRÉE #0 */ 
#define POINT 11 /*X ORJECT in TREE #0 */ 
define EGAL 12 /X DRJECT in TREE #0 */ 
#define PLUS 15 /* OBJECT in TREE #0 */ 
#define MDINS 14 /* OBJECT in TREE 40 %/ 
#define MUL 15 /* OBJECT in TREE #0 */ ' 
define DIV 16 /Xx DBJECT in TRÉE #0 */ 
#define ECRAN 19 /* OBJECT in TREE #O */ 
#define FIN 20 /%X DBJECT in TREE #0 */ 
#define CA 17 /*X OBJECT in TREE #0 #/ . ! 
#define CE 18 /* OBJECT in TREE #0 */ : 
| FICHIER DES RESSOURCES £ 
Le 
define TOOBU 0 L 
| fidefine FREEBB G * 
#tdefine FREEIMG 0 v 
#define FREESTR 22 £ 
BYTE *krs_strinost] = € 
non, 
DO 0 
nan 
“3, # 
van, # 
msn, 4 
| Do # 
u7n? # 
up", # 
: "gu, # 
j mou # 
l rt # 
j 8 
A 
| / 
l ? 
/ 
| " 
/ 
: UOFF">; 
ï # 
î # 
Î # 
# 
LONG rs_frstrl] = € 
\ 0; _ 
#3 
BITBLK rs_bitblkt] = € 
Où; . # 
LONG rs_frimgli = € 
Où; 74 
F à 48 
| 


ICONBLK rs_iconbikt] = € 
0); 


TEDINFO r5_tedinfol] = € 
18L, 19L, 20L, 5, 6, O, O11H0, O0, —1, 152035 


OBJECT rs_objectl] = € 

1, 1, 20, G_EOX, NONE, NORMAL, Ox21100L, 0,0 24,153 
2, —1, —i, G_BUTTON, Ox5, NORMAL, OxOL, 3,13, S,1, 
3, -1, -1, G_BUTTON, 0x5, NORMAL, Oil, Sslts Sir 
4, —1, —1, G_BUTTON, 0x5, NORMAL, OX2L, Byllr Sols 
5, -1, —1, G_BUTTON, 0x5, NORMAL, OXSLS, 1319 Srls 
8, —1, -1, G_BUTTON, 0x5, NORMAL, OXAL, Ss75 Suds 

7, —1, -1, G_BUTTON, 0x5, NORMAL, OXSL, 6395 Ssls 

8, -1, -1, G_BUTTON, 05, NORMAL, OhGL, 15597 Ssly 
9, —1, rt, G_BUTTON, 0x5, NORMAL, ON7Ls Sr75 Sols 
20, -1, -1, G,_BUTTON, Ox5, NORMAL, OùBL, 6,7r 15 
22, 1, 1, GLEUTTON, 0x5, NORMAL, On9L, 19:75 Gris 
22, 1, —1, G_BUTTON, Ox5, NORMAL, OxAL, Bo1Ss Sr 
45, -1, -1, G_BUTTON, Ox7, NORMAL, OXBLs 13,131 Ssds 
14, 1, -1, G_BUTTON, 0x5, NORMAL, OXCL, 19:13, Sols 
45, 1, -1, G_BUTTON, 0x5, NORMAL, OxDL, 18,14, Syis 
16, —1, 1, G_BUTTON, 0x5, NORMAL, OKEL, 16:97 Sols 
17, 1, 1, G_AUTTON, O5, NORMAL, OXFL, 18,73 Sole 
18, —1, —1, G_BUTTON, Où5, NORMAL, Ox10L, SySs Onls 
29, —1, 1, G_BUTTON, OxS, NORMAL, Oxiils 15:53 br 
20, -1, -i, G_FBOXTEXT, EDITABLE, NORMAL, OxOL, 3,19 
0, -4, -1, G_EUTTON, O0x25, NORMAL, Ox1SL, 33 8,135 


25 rs trindexlt] = € 


>; 

struct foobar € 
WORD dummy; 
WORD Ximages 


> rs_imdopel] = { 


NUM_STRINGS 22 
NUMIFRSTR 0 
NUM_ IMAGES 0 
NUMLBE © 
NUM_FRIMG © 
NUM_1B O 
NUMCTI 1 

= NUM_OES 21 
NUMUTREE 1 


2YF= pnamel] = "CALCUL.RSC"} 


7x CALCULATRICE 
Pér-rtersS Er SECTE STE SES ETS EST EEE CE EEE TETE 


PES STSS LITI SEC IS TS ECESS EST ETS ETES EST TETE ETS 
*/ 


TE Fichiers inclus *x/ 


#inciude <stdio.h> 

lude "gemdefs.h" 
clude “calceul.h" 

#rciude "obdefs.h" 


dx Definitions *x/ 


+ define PASFEN (1) /* fenetre non ouverte */ 


PE Variables */ 


18,1, 


extern char __atabli; /* pour eviter erreur a l’eédition de liens */ 
extern int gl_apid; 7*x identificateur AES */ 

/* Tableaux des parametres VDI */ 
int contrili13; /* pour stockage des parametres fonctions %*/ 
int intince0]; /* pour parametres entiers en entree */ 
int ptsinc1281; /* pour covrdonnees entières de pts en entree */ 
int intoutc451; /*% pour parametres entiers en sortie k/ 
int ptsoutC121; /* pour coordonnees entieres de pts en sortie #/ 
long arbre; /* adresse de l’arbre RESSOURCES x/ 
int menu_id; /*X identif, de l'accessoire */ 
int id_vdi; /*% identif, VDI de l'accessoire #/ 
int id_fen; /% identif. de la fenetre de l'accessoire */ 
int id sta; /* identif. de la station X/ 
int mess_tpl61:; /* tampon ou sont stockes les messages */ 
int cpt; /* compteur de caracteres de calculatrice %k/ 
int ht_fen = 260; /* hauteur de fenetre */ 
int 1g_fen = 168; /*x largeur de fenetre *X/ 
int #_fen = 220; /*% coord. X de fenetre */ 
int y_fen = 80; /* coord. Y de fenetre */ 
char *Xfen_titre = " CALCULATRICE "; /*X titre de 1a fenetre */ 
char chai ec CiS1; /% chaine entree à l’ecran *k/ 
char aff.on [éïs "ON "; /*% bouton MARCHE *K/ 
char aff_off C4ï= "OFF!" /* bouton ARRET X*/ 


PÉTTÉTÉTI IIS ES DDIES ESS EISITI DIET TEITTTIIIITI TITI III III 10 
/* Gestion de 1a calculatrice */ 

gere._cal (0 

€ 


int 53 

int sortie; /*% objet occasionnant la sortie */ 
long ted_adr; 

char val: 


ted_adr=((long) x((1ong 4) (arbre+12+24#ECRAN) )): 
x CUong %*) (ted_adr))=chai_ec); 
CCint) XCCint X) (ted_adr+24))=13)4 
/* l'adresse de "“chai_ec" est place dans la struct. TEDINFO #/ 
/* le champ d'édition pointe maintenant sur "chai_ec" */ 


CXClong #) (arbre+12+24XFIN)) = aff on; /*x modifie bouton OFF */ 


trace, ob; (FIN); 


cpt=(-1);3 
while (1) 4* sortie de boucle si cliquage bouton ON */ 
< 
sortiesform do (arbre, ECRAN); 
if (sortie== FIN) Ck(long %) (arbre+12+24XFIN)) = aff_off: JX OFF %/ 
desel_ab; (sortie); /* objet de sortie en video normale */ 
if (sortiem= FIN) € 
For; = 03 3 < 143 5#+) chai_ecl;1=0; breaks 2 /* vide l’ecran */ 
switch(sortie)< 
case EGAL: if (travail()) break; /x fait le calcul %/ 
case CA: for(j=0p5;<14; ++) chai_ecl;1=0; /* efface la chaine */ 
cpt=(-1)3 breakz /%X reinitialise le compteur */ 


case CE: if (opt 3=0) chai_ecCcpt--150; break; 
default: if (cpt >11) break; 
cpt++; 

switch (sortie) € 

case MUL: val=’%’; breaks 

case DIV: val=’/*+ break; 

case PLUSr vals'+"; break; 

case MOINS: val=’ 7 ;break; 

case POINT: vals=”.*;break; 


50 


default: val=sortie+47; break:/*k pour chiffres */ 
3 /4x fin SWITCH secondaire *x/ 
chai _ecCoptisval; /4X ajoute chiffre à l'ecran *x/ 
} /%x fin du SWITCH principal */ 
trace_obi (ECRAN); /* retrace nouvel ecran */ 
3 /* baucle WHILE */ 
trace_obs (FIN); /* place chaine OFF */ 
£race_ob; (ÉCRAN); /* affiche un ecran vide */ 
72 Definit les operandes, l’operateur. Au retour, resultat dans chai_ec */ 
travail () 
Le 
char op_ilci43; /* chaine pour premier operande */ 
char op.201413; /* chaine pour deuxieme operande */ 
cher op.eur; /* operateur */ 
ei 
i,5res; 
1g9_1:19..2; /* longueurs des deux operandes */ 
1g_max, Prec mani 
dec _.1=0; JX nombre de decimaux des */ 
dec _250; /*x deux aperandes */ 
£er (ir0; (e=chai_ec£11) && test_nb (e, Ndec_1)) (1<14)% ++) 
op.iltiischai eclil; 
cp_1ti3=0; ZX termine la chaine par valeur nulle */ 
_isi-ts /* longueur du fer operande */ 
4£ Ci) tt (est_opptchai ecti1))) op_eur=chal ecti++1; 
sise return (0); /*X/"erreur: pas d'operateur ou pas de premier on, */ 
£or(:=0; (e=chai_ecfi1) && test_nb (c, dec_2)) ge CA14) sit, 5) 
ap_2tsi=chai ecCi3; 
35 C5) return (0); /* erreuripas de deuxieme operande */ 
c»_2t:3=0; /% termine chaine par valeur nulle *k/ 
1Q_2=5-1; 
1g_nax=((l1g_1>19_2) ? 1g_1 11g.2)1 /% longueur mani d'operande */ 
srec_nax=((dec_1>dec_2) ? dec,.1 sdec_2)} /x definit precision mat. */ 
res-operation (prec_max-l, opus OP2r S&op_eur) + J*x fait l’operation */ 
sup_zero ()3 /*x supprime les zeros non significatifs */ 
return (res); 1% retourne 1, validant le resultat #*/ 
_ 
22 Esieule le resultat de 1’operation LYA 
æsration (precis,pre.op, deu op, op_r) 
2=$ crecis; /* precision demandee *x/ 
zr pre_opl1; /* premier operande */ 
céer deu_opl1; /* deuxieme operande %*/ 
ee topr; /*x operateur */ 
res_i,res_2,resuls 
atof 03 J* deciarations des fonctions de bibliotheque: */ 
£toa(); /% obligatoires puique ne retournant pas un entier */ 
satof (pre_op)3 /*X convertit une chaine en flottant 4/ 
{deu,_op); 
suitch(#op 1) € 
case’ 'iresulsres il * res_2; 
precis=((precis>2)? 3 s(precis+i)); break; 
case’/':if (res :2#=0) return(o)s 
resuisres_1i / res_2; 
precisss} break; 
case”+’sresul=res 1 + res_2; break; 
case’'-*"t#resulrres_i - res_?2; break; 
> 1% fin du SWITCH */ 
£=52 Gresul,chai_ec,precis?3 /% convertit un flottant en chaine */ 
resvra (1)3 /*X pas “d'erreur L 74 
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/*x Teste si chiffre ou *,", compte nombre de decimaux */ 


est_nb (carac,;decimal) 
char caract 


int #kdecimal!; /*X compteur de decimaux */ 


LA 
int reps0; 


ifticarac>="0") && (caracé="9)) rep=l; /%x "carac" est Un chiffre */ 
if Ckdecimal) (xkdecimal)++; /* si chiffre decimal, compteaur+i k/ 
if CC! Ctdecimal)) && (carac==”.")) € 
{Xdecimal)=is /* rencontre du ",": debut du compteur */ 
repzi; Ë /+ caractere "," valide */ 
> 
return(rep}s /* si 0, erreur; si 1, caractere valide */ 
> 
/4 Teste si operateur */ 


est_opp(carac) 
char carac; 
à 4 
switch(carat) € 
case ?+°: 
case 7’: 
case "#1 
case ?/’: return(1): 
default 


iiss € 


> 
/* Supprime les zeros non significatifs *X/ 


sup_zera() 


{ 
int 4,53 
char cÿ 


fort i = Ogée = chai_ect11)3 i++) /X tant que fin de chaine non trouvee 
Âf (e==7,?) jai; /* 5= position du point decimal 


cpt = i-1, /* compteur de chai_ec 
if (!5) return(0); /X 11 n’y à pas de point decimai 
for(i-si; 12535 1) € 

1f Ctchai_ecLiïms’ 07) 11 (chai_ecli]un".*)) 


{ 
chai_eclti1 = 0:/*X supprime les zero depuis fin de chaine 


cht—-; 
à 
else break; /*x si chiffre significatif trouve: STOP 
3 /*x fin de boucle FOR 


/* Deselectionne et trace l’objet "quel" */ 


desel_obj (quel) 
int quel: 
+ 


nt x_clip,y._clip,lg_elip,ht.clip; 
wind_get (id_fen, 4, %x_clip, &y_clip, &lg_clip, &ht_clip); 


ob5c_change (arbre, quel, 0, x_clip, y_elips 1g.clip, ht_clip, 0, 1)3 
> 


/4 Redessine l’objet "quel" sans modifier son etat #4/ 
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/*X c'est un operateur */ 
return(0); /* ce n'en est pas Un */ 


*/ 
*/ 


*/ 
*/ 


*/ 


*/ 
*/ 


mn —_ Hd 


cb; (quel) 
cual; 


int x_clip, y.clip, lg_clip, ht_clips 


snd_get (id_fen, 4, tt clip, &y,clip, &ig clip, &ht_clip); 
es;c_draw (arbre, quel, 0, x.clip, y_clip, Jlg_clip, ht.elip}s 


"# Fssitionne la boite de dialogue aux coordonnees de la fenetre *#/ 


mtionne () 


ai, y_dial, 1g_dial, ht_dial; 


me _get (id_fen, 4, &x_dial, &y_dial, &lg_dial, &ht_dial); 
/* demande les coordonnées de la fenetre */ 
TECaint #) Carbre+i6))) = x dial; 
/*x modifie dans la structure d'objet la coord. X de la boite #/ 
Téêdint +) (arbre+18))) = yÿy_dial; 
/X modifie dans la structure d'objet la coord. Y de la boite */ 


"1 


3 Sescion des messages recus */ 


ie 
à 


22 4% Cette boucle n'est pas sans fin pour le systeme: les autres */ 


#3 accessoires et l’application courante sont egalement interrages */ 
{4) 


evnt_mesag (mess_tp); /*X attente d’un message */ 

wind_update(1)} /X interdit les interferences */ 

switch (mess_tp LO1) 

€ 

case WM_FULLED: if(mess_tpCS)=sid_fen) gere_cal(): 
break; 

cese WM_REDRAW: Âf (mess_tplS]==id, fen) 

retrace (mess_tpl4], mess _tp(51, mess_tplé, mess_tpC7J); 

break; 


case WM_MOVED: ifimess_tplS]==id fen) © 
mind_set(id_fen, 5, mess_tp (41, mess_tp[5]l,mess thlé), mess _tpC71); 
positionne ()3 3 /* place "arbre! aux coord. fenetre */ 
break}; 
case AC_OPEN: 
(aess_tpl4]1 == menu_id) € 


Gid_fen == PASFEN) < /* si fenetre non deja ouverte */ 
ouv_sta ()3 /* ouvre station *#/ 
4f (rep = ouv_fen()) fin_app(trep); 

3 
else wind_set (id_fen, WF_T0F,0,0,0,0); /* sinon rend active */ 
2 break; 
cese WM_CLOSED: if (mess._tpl[Si==id_fen) fin app (2)5 
break} 
case AC_CLOSE: if ((mess_tplSï==menu id) &% (id,fen !# PASFEN)) 
fin_app (1): /*x ferme l'accessoire */ 
break; 


case WM_NEWTOP: 
case WM_TOPPED: if (mess_tp[S] == {d_fen) € 
wind_.set (id_fen, WF_TOP, 0, 0, O0, O)53> 


break; 
3 “ind_update (0); /* fin de boucle SWITCH */ 
z /* boucle WHILE *%/ 
T Fzsressse de la fenetre */ 
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retrace (x, Y, 194 ht) 


int #,Y,1g3ht3 /* coordonnées du rectangle a retracer #/ 
€ 
GRECT source, dest, boite; /*X structure de rectangle (cf OBDEFS.H) */ 
source.g_x = X; Source.g_y = ÿ} 


$ 


vx 


source. g_w lg; source.g_h = ht; 
wind_get tid_fen, WF_FIRSTXYWH, &boite.g_x, &boite.g_y, %boite.g_ws 
#boite.g_h}s /* demande premier rectangle de la liste */ 
while (boite.g_w %& boite.g_h) © 
dest.g,.x* boite.g_*; dest.g.y = boite.g. y; 
dest.qg_w boite.g_w; dest,.g_h = boite.g_h; 
if trce_intersect (source, &dest)) /*X si intersection, retracer */ 
obic_draw tarbre, 0, 2, dest.g.x, dest.q _ys 
dest.g_w, dest.g_h)3; 
wind_get Gid_fen, WF_NEXTXYWH, &baite.g_x, %boite.g_y. &boite.g.w; 
&boite.g hs: /X demande rectangle suivant de 1a liste */ 
3 /*x fin de boucle WHILE */ 


Fin d'accessoires ferme fenetre et station selon "type ret" */ 


#in_app (type_ret) 


in 
LA 


> 
/* 


14 type_ret} 
switch(type_ret) 
< 


case 2: 
wind_close (id _fen); /*X ferme la fenetre */ 
wind_delete(id_fen)s /* supprime la fenetre */ 
case 11 1 
v_clavuk (id vdi) 3 /* ferme la station virt. de travail */ 
id. _fen = PASFEN; 
break; 
/* fin du SWITCH */ 
/* retourne attendre un evenement */ 


Creation et ouverture de fenetre */ 


ouv_fen 0 


L 


#o 


3 
LE 


ma 
Le 


id_fen = wind_create (01000f, x_fan, y_fan, 19,.fen, ht_fen); 

/* cree une fenetre avec barre de deplacement, case de sortie, */ 

/* et case de "pleine fenetre" */ 
if Cid fen == (-1)) © J* si creation impossible ..,%/ 
rm_alert (1,"C31CGEM n’a plus aucunelfenetre en reserve!3[Desolel"); 
return (15 7 

wind_set (id, .fen,2, (long)fen_titre,0,0)3 /* place titre de fenetre */ 
wind, open (id, fen, x_fen, y.fen, 1g_fen, ht.fen); 
graf_mouse (O,OxOL) ; 


positionne ();3 /* place l'arbre a La position de la fanetre */ 
return (0)3 /*x tout va bien */ 
PROGRAMME PRINCIPAL: initialisation de l'accessoire */ 

ino 

int viwsus y /4 variables inutilisees */ 


appl_init(); 
id_sta = graf handle (fev, fu, 8x, &y)3 
ifirsre_ load ("CALCUL, RSC") ) /* si fichier de ressources introuvable */ 
© 
graf, mouse (0, CHOL3A 
Form_alert (1, "CS1CErreur Fatale !ICALCUL.RSCIFichier inconnu]EArreti"); 


appl_exit(3 /* fermeture de l'accessoire */ 

menu_id = menu register (gl apid, “ Calcul ")3 

id.fen = PASFEN; 

rsrc_gaddr (0, CALCUL, &arbre)3 /*x demande l'adresse de l’arbre */ 
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er 0; /X attente des evenements, n'en revient jamais */ 


CE] 


æ Dre station de travail virtuelle #/ 


LE 


tn£113, arg_outl#71, i3 

= id_sta; 

2=055<10;1++) arg_intiisif 
-_=vkierg in, tid vdi arg_out); 


2.4. Erreurs de programmation 


Le défaut majeur des langages compilés tient sans doute à l’absence 
Ja-rye syntaxique et lexicale lors de l’édition du programme. Ces erreurs 
res déectées qu’à la compilation, parfois lors de l'édition de liens seule- 
=, à moins que l’on n’utilise un programme de « lint » qui, d’ailleurs, 
ze <%ecera que les erreurs de syntaxe les plus grossières. Or la compilation 
== phase longue surtout pour des programmes importants, de plus l’accu- 
—— sc 9n d'erreurs (ou certaines erreurs spécifiques) provoquent fréquem- 
= va « plantage » du compilateur, les erreurs ultérieures n’étant plus 


Zarocées. 


Por ioutes ces raisons il est particulièrement conseillé d'éviter les erreurs 
== Pon programme en C ! Aussi analyserons-nous ici quelques types 
Fees varmi les plus fréquentes ou les plus « vicieuses », le lecteur pou- 
= 25 ailleurs se reporter en 3.1.4, pour un exposé des règles générales 

—czrammation. Les pages qui précèdent ayant apporté les éléments de 
Erse£e le programmation en C, nous ne saurions que vous conseiller de vous 
TEE à d’autres ouvrages pour approfondir vos connaissances tout en vous 
-z—srdant de toujours garder à l’esprit les spécificités de chaque com- 
== C. A titre d'exemple, sur le 520ST seul l'emploi de 3 variables « regis- 
= » ax amorisé (correspondant à D7, D6 puis DS). Notons d’autre part 
<= com de variable ou de fonction C n’est identifié que par ses SEPT 
ess caractères (ainsi « fichierx’? et “fichiery”’ sont équivalents pour le 


IEEE...) 


Z£.1. Erreurs de syntaxe 


Les erreurs de syntaxe résultent bien souvent d’oublis : 


— 45 du symbole “‘;” après un appel de fonction ou une initialisation 
Ze vertable. 
= =—%3 d'une accolade de fermeture d’une fonction ou d’une instruction. 
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_ 4,5 au lieu de “:”?, souvent une faute de frappe due à la contiguité de 
ces deux touches et délicate à détecter. 
— oubli de parenthèse, surtout dans une expression complexe. 


Ces erreurs, les plus habituelles, sont repérées à la compilation mais pro- 
voquent souvent un dérapage de celle-ci, l’oubli d’une accolade conduisant 
par exemple le compilateur à inclure les instructions suivantes dans la fonc- 
tion précédente, d’où une suite de messages d'erreurs. Pour les éviter, l’atten- 
tion est la meilleure arme mais certains « trucs » sont utiles : 


— demander à l'éditeur de rechercher toutes les occurrences de “:?? et véri- 
fier qu’il s’agit d'expressions conditionnelles ou de « case ». 

— demander à l'éditeur de rechercher toutes les occurrences de “)<CR> ” 
lesquelles ne doivent survenir qu'après des noms de procédures ou après 
une instruction du type « if », « for », « while » ou « switch ». 

— indiquer en commentaire à côté des accolades fermées la nature de la bou- 
cle ou de la suite d'instructions ainsi clôturée. 


Une erreur de syntaxe particulièrement habituelle chez les programmeurs 
ayant débuté en Basic est l’utilisation de: if( <expressionl> = 
<expression2 >) au lieu de : if( <expressionl> = = <expression2> ). Cette 
erreur est redoutable parce qu'en fait non contraire à la syntaxe donc non 
détectée à la compilation. Or ‘‘<expressionl> = <expression2 >”? étant 
vrai tant que <expression2 > est vrai, puisqu'il s’agit d’une affectation, les 
conséquences de cette erreur sont souvent funestes. 


Attention également aux opérateurs accolés au signe égal, certains com- 
pilateurs acceptant par exemple ‘=&”? au lieu de “‘&= ?? ou le signalant par 
un simple « warning ». Or si, dans votre esprit, le “&*? suivant l'égalité indi- 
quait une adresse, il sera compilé comme un ET logique. Laissez donc tou- 
jours un espace après le signe d'égalité, cela vous évitera quelques déboires ! 


2.4.2. Méconnaissances 


Même le programmeur en C le plus chevronné confond parfois un poin- 
teur et un pointeur de pointeurs, ou le contenu et le contenant. Une règle 
de bon sens voudrait que l’on ne programme qu'avec les outils dont on à 
acquis une parfaite maîtrise. malheureusement, ces outils sont parfois insuf- 
fisants et les progrès naissent des expériences, même cruelles. Aussi les mécon- 
naissances sont-elles à l’origine de nombre d’erreurs. 


Pour les éviter, un seul remède : étudier ! Cent fois sur le métier. N’ayez 
pas de honte à consulter les ouvrages de base sur le C (cf. bibliographie en 
fin d'ouvrage), il n’est pas rare de voir des développeurs pourtant aguerris 
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ES le syntaxe de telle ou telle instruction. Au-delà des instructions C, 
eurant peu nombreuses, ce sont surtout les pointeurs et les structures 
oquent des erreurs. Sur les pointeurs, les pages précédentes offrent l 
= zxerçu mais nous ne saurions trOp vous conseiller la prudence quant à 
a fisarion si vous débutez. Mieux vaut parfois créer un tableau de carac- 
es ame risquer d’utiliser un pointeur de chaîne à mauvais escient ! ! 


=D. 


Les sructures sont parfois indispensables (ainsi la structure FILE pour : 
Æorhèque standard C ou les structures GRECT et OBJECT pour les ; 
kèques GEM). Pour mieux les connaître, il est INDISPENSABLE de 
= & d'étudier les fichiers de définitions fournis avec le compilateur (en 
ze “stdio.h”' et ‘‘obdefs.h??). Relevons à ce propos que la structure s 
- EE v utilisée en CP/M 68k n’a que peu à voir avec la structure « FILE » 


EUNEKX telle qu’elle est décrite dans l'ouvrage des « pères » du C ! 


Le sructure FILE citée plus haut incite à une remarque d’un ordre voi- 
= : © se faut pas confondre un fichier (ouvert par « open », fermé par 
: Lee », lu et écrit par « read » et « write ») avec un canal (ouvert par 
£ mn », fermé par « fclose », lu.et écrit par « fread » et « fwrite »). L'un 
2 l’autre permettent de traiter un périphérique où un fichier disquette 
=, æ'ors qu’un fichier est repéré par un numéro (id_fich), un canal est à 
—ED<E per un pointeur de structure (FILE, voir fopen, Annexe 1). D’autre 
ZE. à en canal est associé un tampon, ce qui autorise un accès séquentiel | 
EE per le pointeur de position, alors qu’un fichier est à accès direct | 
Es $ « lseek » autorise un accès séquentiel indirect). 


Z4.3. Les pièges 


Zn a pas de pièges en C... tout juste des méconnaissances, des incom- 
-Æ=<ons, des zones d’ombre et des erreurs de programmation ! Le Ca 
; s des particularités dont l’importance est parfois mésestimée. De plus 
æezss signalées dans ce paragraphe ne sont habituellement pas détec- 
“2 # 2 compilation et difficilement repérables à l'exécution, sinon par le 


Ban Var 


= ='elles engendrent les résultats les plus inattendus, 


tone des cause d'erreurs « vicieuses » les plus classiques tient à la con- 
== re types de variables et spécialement entre le type « char » et le 
7e < Ex » ainsi qu'entre les types signés et non signés. Ce type d’erreur l 
Le aire le programmeur confirmé mais certains cas de confusion sont ! 
Es raines. Ainsi : 


re € (atb)/c }: 
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se traduira par une multiplication des entiers a et b avec un résultat ENTIER, 
lequel résultat entier sera ensuite étendu à un entier long puis divisé par c. 
La fonction correcte est : 


int muldiv(a,b,c) 
int a,b,c; 


return € € (long) afb)/e )3 


La confusion des types atteint des sommets lorsque l’on utilise une varia- 
ble définie comme de type « char » pour servir d'indice de tableau, par exem- 
ple pour convertir un caractère à partir d'une table de conversion. Car si, 
par hasard, la variable indice est supérieure à 127 (donc un caractère néga- 
tif) on obtiendra un indice négatif, car un indice est TOUJOURS ENTIER 
et le caractère négatif sera étendu à un entier négatif. Inutile de décrire le 
tableau ! 


Les erreurs d’incrémentation et de décrémentation sont aussi couran- 
tes. Rappelons que l’incrémentation d’un pointeur se traduit par un ajout 
de 1 si le pointeur pointe des caractères, de 2 s’il pointe des entiers, de 4 s’il 
pointe des longs mots. Cette règle simple et parfaitement logique est parfois 
délicate à appliquer. Ainsi : 

char x fichlist ; 
définit un pointeur pointant sur des pointeurs de caractères. Donc : 

fichlist + =4; 
provoquera une incrémentation de 76 de fichlist. 


Quelques règles de bon sens doivent aussi rester présentes à l’esprit. Ainsi 
le contraire de ‘>°? n’est pas “‘<*’ mais, bien sûr, *< =??... Enfin le pro- 
cessus de compilation (voir chapitre 4) et ses particularités doivent être bien 
appréhendés. Il faut par exemple savoir que le compilateur Digital Research 
convertit l’opérateur de décalage à droite “> >?? par l'instruction 68000 
« asr », ce qui conduit pour un nombre non déclaré comme « unsigned », 
et de bit fort à 1, à un remplissage des bits forts par des « 1 ». Il est égale- 
ment préférable d'éviter l’emploi de noms de variables ou de procédures pré- 
cédés d’un trait de soulignement “*_”’, certaines variables système utilisant 
ce préfixe. D'une façon générale, mieux vaut utiliser des noms de variables 
ou de fonctions français, c’est encore ainsi que l’on risque le moins de défi- 
nir un nom déjà défini par le système ! 
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2Æ.4. Les confusions de bibliothèques 


Le souci d’être compris, et peut-être un certain manque d'imagination, 
I aené les concepteurs des bibliothèques C à utiliser des noms de fonc- 
= Fès proches, source de confusions multiples pour le débutant qui en 
TE souvent à reléguer au placard toute une bibliothèque de peur des erreurs 
2==—=pulation ou simplement parce qu’il a l'impression qu’elle fait dou- 
I &p'oi avec une autre. 


cle une dysiexie accentuée peut provoquer la confusion entre l’ins- 
Tate C « break » et la fonction C « brk() », mais il peut arriver de con- 
== & fonction standard « malloc ( ) » et la fonction gemdos « Mal- 
—£ { }»ou la fonction standard « fopen » et la fonction gemdos « Fopen ». 
ZT æ n’est pas sans conséquences ! Ainsi « malloc » utilise un nombre 
ZANTIER pour réserver une zone mémoire alors que « Malloc » utilise un 
ENTIER LONG, permettant ainsi de réserver une zone de plus de 64Ko. 
== Ë linstruction « fopen », elle ouvre un CANAL et retourne un poin- 
Ze sracture FILE, alors que « FOPEN » ouvre un FICHIER et retourne 
E cateur de fichier. On pourrait penser qu’en conséquence « Fopen » 
EX tique à « open ».. et effectivement les paramètres d’appel sont iden- 
Sais « Fopen » retourne un identificateur LONG alors que « open » 
-TE un identificateur ENTIER. Cet identificateur étant utilisé pour l'accès 
ÆÆ Semeture du fichier, ces fonctions ne sont pas interchangeables ! 


Z existe des cas de double emploi, ainsi la fonction C « sbrk » est iden- 
à PiermO (Trap 1, fonction 0), elle-même identique à Pterm(0) (Trap 
=-T==on SAC), encore identique à Trap 2 avec DO =0 ! Ces cas sont toute- 
Zexcæption et, bien souvent, les fonctions système (analysées en Annexe 
— crient des améliorations ou des facilités d'emploi vis-à-vis des fonc- 


225 sendard. 


Ze compilateur C utilisé par l’auteur autorise l’appel en C de 99 fonc- 
Ts Cstandard (annexe 1), de 93 fonctions système (annexe 4), de 96 fonc- 
== VDI et de 66 fonctions AES (annexe 2), soit un total de plus de 350 
[SSS ! Par comparaison le nombre d'instructions C est presque ridicule 

5 ©}e laisse deviner l’importance d’une bonne connaissance des bibliothè- 
IS, ss lesquelles il n’y aurait tout simplement pas de programme C. 


Z%5 Erreurs de documentation 


Ne fañes jamais une totale confiance dans la documentation, Sans par- 
2 Te sriains ouvrages où l'accumulation d’erreurs laisse pantois, même la 
2 =ation livrée avec votre compilateur C doit être remise en cause. Vous 
ZE d'ailleurs, au fil de cet ouvrage, nombre de correctifs apportés à celle-ci 


59 


mais, même si en écrivant et en relisant ce livre, nous avons tenté de traquer 
la moindre erreur, l’infaillibilité n’est pas de ce monde. Seule votre expé- 
rience est un guide solide en la matière. 


Lorsque l’on constate en ouvrant la documentation sur le GEM que les 
pages de départ sont consacrées au double système de coordonnées NDC et 
RC alors que seul le système de coordonnées RC est implanté sur le 520ST, 
on doit devenir soupçonneux. Lorsqu’on s'aperçoit que certaines instructions 
VDI (v_cellaray ou vrq_valuator par exemple) sont prises en compte par le 
compilateur mais non exécutées, on devient logiquement prudent ! 


Plus encore que les erreurs, ce sont les manques dans la documentation 
qui conduisent à des programmes apparemment parfaits mais parfaitement 
inutilisables sinon pervers. En ce domaine encore l'expérience est la seule 
règle, surtout lorsqu’on profite de l’expérience des autres ! L'étude de lis- 
tings de programmes même courts (surtout courts, si vous débutez) est hau- 
tement profitable. Si l’auteur n’est pas lui-même un débutant, la moindre 
tournure étonnante doit en être examinée, elle correspond souvent à la réso- 
Jution d’un problème et même si l’auteur ne saurait expliquer précisément 
pourquoi ça marche ainsi, l’essentiel est bien que ça marche ! Le pragma- 
tisme est de rigueur en programmation. 


Parmi quelques manques, signalons par exemple que la modification 
de hauteur de caractères en GEM (vst_height) ne fonctionne en hauteur 
qu'avec des multiples de la hauteur de police mais que les valeurs intermé- 
diaires se traduisent par une modification de la largeur. Notons aussi que 
les attributs de remplissage n’ont aucune influence sur le tracé de caractère, 
ainsi une couleur de remplissage noire et une couleur de texte blanche sur 
un écran blanc conduisent à des caractères invisibles, car blanc sur blanc ! 


Enfin, certaines règles non définies rendent un programme plus sûr : 
appeler la fonction « wind_update(1) » avant de modifier l’écran, effacer la 
souris avant un affichage, réserver une zone mémoire pour stocker le con- 
tenu de l'écran et le récupérer pour retraçage, ne jamais réserver toute la 
mémoire disponible mais en laisser au moins 4Ko pour le système (cf. 
fsel_input( } ), etê., selon le type de programme que vous désirez faire. 
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3. PROGRAMMATION 
EN ASSEMBLEUR 


Les instructions et les modes d’adressage du 68000 seront supposés connus 
= Jeu, leur étude pouvant être effectuée à partir de l’un des ouvrages 
ESS dans la bibliographie, L’annexe 5 fournit un récapitulatif des ins- 
TRES avec les modes d’adressage admis et l’incidence sur le registre d'état, 
2x aide-mémoire dont la consultation pourrait se révéler utile lors de la 
TEEmmation ou de la lecture de ce chapitre. 


æ 


<.1. Méthodes de programmation 


£2 programmation en assembleur 68000, de par l’étendue du registre 
Zevaions et des modes d’adressage, est un régal ! Elle se rapproche d’ail- 
= considérablement de la programmation en C dès lors que l’on dispose 
== rato-assembleur (ce que n’est pas l’assembleur de Digital Research), 
= & auiorisant de nombreuses fonctions système et quelques fonctions 
TE sxpplémentaires, non connues du compilateur C. 


Le passage d’un programme assemblé à travers l'éditeur de liens per- 
ZE 2 éffet de bénéficier de toutes les bibliothèques système. Il est donc 
Te d’appeler en assembleur, par exemple, la fonction VDI vclrwk (effa- 
ZX d'écran) par : 


Sex identif,-(a7) 
=" veiruk 
ET 22,e7 


Ces trois lignes appellent plusieurs commentaires : 
1) la variable « identif » représente l’identificateur d’application renvoyé lors 
de l'ouverture de celle-ci (voir v_opnvwk, Annexe 2). Elle correspond donc 
à une donnée initialisée en assembleur dans « .data » par : 


identif ds.w 1 


On notera que l’appel de « identif » dans un programme permet de lire 
ou écrire le contenu de cette variable, alors que l'appel de « # identif » per- 
met de lire l’adresse de cette variable. 


2) L'instruction GEM velrwk est précédée d’un trait de soulignement. Ce 
trait de soulignement doit OBLIGATOIREMENT précéder tous les labels 
et noms de variables externes au programme, donc faisant référence à 
un autre programme (en C ou en assembleur) ou à des fonctions GEM. 


3) L'une des particularités de l’assembleur tient à la gestion de la pile, qui 
se traduit en l'occurrence par la dernière instruction de mise à jour. Cet 
aspect sera developpé plus loin. 


Le langage assembleur 68000 est un langage simple, les opérations élé- 
mentaires réalisées étant aisément compréhensibles (lecture ou écriture de regis- 
tre ou de mémoire, opérations logiques (ET, OU, comparaison, test, ect.), 
opérations arithmétiques (addition, multiplication, décalages, .….). Les dif- 
ficultés naissent de certaines instructions sophistiquées, de particularités inhé- 
rentes à quelques instructions, de l’utilisation de fonctions externes (système 
ou GEM) et de la nécessité de structuration du programme lui-même. Aussi 
aborderon$-nous chacune de ces difficultés dans les paragraphes suivants. 


3.1.1. Instructions sophistiquées 


Instructions utilisant le bit d’extension X (ADDX, SUBX et NEGX). 


Le programmeur formé à l’assembleur 6800 ou 6809 se sera sans doute 
étonné de l’irruption de ce nouveau drapeau du registre d’état : l'indicateur 
d'extension X. L'intérêt de ce drapeau, proche de l'indicateur de retenue C, 
tient à ce qu’il n’est positionné que par un nombre très réduit d'opérations : 
les additions, les soustractions, les négations et les décalages logiques et arith- 
métiques. Il n’est pas modifié par les transferts (move), les opérations logi- 
ques et les multiplications et divisions, contrairement au bit de retenue. Il 
constitue donc un indicateur de base fort utile, en particulier pour des bou- 
cles associant opérations arithmétiques et transferts ou tests. 


L'instruction NEGX apporte une possibilité supplémentaire, en autori- 
sant la prise en compte de la retenue dans le positionnement d’un drapeau. 
Aïnsi : 
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air & 1,40 

ex i di 
Te ss DI1 l'inverse de son contenu si le bit 15 de DO était à 0 et placera 
D1 inverse moins un de son contenu si Le bit 15 de DO était à 1 (si 
ZT = mul, il sera respectivement égal à 0 ou —1, soit SFFFFFFFF). 


Ze Eï d'extension X a donc une fonction proche du bit de retenue C 
= T'afdiiion et la soustraction (cf. ADC et SBC de l’assembleur 6800 et 
DC et SBB de la famille 8080). Il offre des possibilités inédites en 


ILE + aégation d’opérande. 


= sn DBcc. Boucle avec branchement conditionnel 


== correspondant parmi les instructions des processeurs 8 bits, l’ensem- 
7222 =sructions DBcc du 68000 ne saurait être comparé qu’aux LOOP, 
ZTITE, LOOPZ, LOOPNE et LOOPNZ du 8086, instructions très primaires 
Ze DB ! Nous n’aborderons pas ici la famille d’instructions de bran- 
cxditonnel (BRA, BEQ, BGE, BHI, etc.) supposée connue et d’uti- 


== és. La famille d'instruction DBcc en constitue une extension, à 
ZI SÉenre. Sa syntaxe générale est la suivante : 


DBcc Dn, déplacement 


Z& € condition compteur de boucles depl. sur 16 bits 
see le processeur exécute cette instruction, il teste tout d’abord la 


IEEE Si celle-ci est vraie, il passe à l'instruction suivante. Sinon, le registre 
LE 2=—ée Dr est décrémenté de 1. Si ce registre est alors égal à —1, le pro- 
2 es à l'instruction suivante. Sinon il y a branchement à l’instruc- 


I FH É par le déplacement. Exemple : 


ZE #7, d0 
ee. D (a0)+, (a1)+ 
Fes | d0,boucle 


Te courte séquence effectué un transfert d’au maximum huit octets 


2x 7e scement pointé par AO vers l'emplacement pointé par A1. Si l’un 


2ÆE ES ransférés est nul, il y a arrêt du transfert. 


L'epérience montre que les erreurs d’utilisation de cette instruction pro- 
TX test de condition. Le branchement n’est effectué que SI LA CON- 


* EST FAUSSE et le registre Dn différent de —1 (SFFFF). Les con- 
SEE programmation viennent de ce que la plupart des assembleurs accep- 
2e zcés d'instruction DBRA à la place de DBF. Or l'instruction DBRA 


63 


-—{ 


n'existe pas et n’a aucun intérêt puisque la condition BRA est toujours vraie 
et qu’en conséquence il n’y aurait JAMAIS branchement alors qu’avec DBF 
il y a toujours branchement SI le registre Dn est différent de —1. 
v, 
Instruction Scc. Test de condition et positionnement de drapeau 
Cette instruction est sans doute l’une des plus méconnues du 68000, à 
tel point que la plupart des compilateurs C l’ignorent.. Sa syntaxe est simple : 


Scc adresse 


condition testée adresse effective 


Si la condition est VRAIE, l’octet pointé par l’adresse est mis à $FF. 
Si la condition est FAUSSE, cet octet est mis à 0. Si l’adresse effective cor- 
respond à un registre, seul l’octet faible est positionné. L'intérêt de cette ins- 
truction vient de ce qu’elle permet de positionner simplement un sémaphore 
(variable booléenne). 


Les erreurs de programmation liée à l'emploi de Scc proviennent avant 
tout du positionnement effectué ($FF si vrai, 0 si faux), différent du couple 
booléen classique 0 et 1. Elles proviennent également d’une utilisation détour- 
née de ce test par le biais des instructions ST (SBRA est admis par certains 
assembleurs) et SF, Dans ces deux cas, il n’y a aucun test mais simple posi- 
tionnement à $FF pour ST et à 0 pour SF. Ce détournement d’instruction 
est à déconseiller, il n’offre pas de gain de rapidité d’exécution et rend le 
programme moins lisible. 


Instruction MOVEP. Transfert vers des mémoires de périphériques 


L’instruction MOVEP sert en principe à transférer des données vers des 
registres de périphériques. Lorsque les circuits de gestion de ces périphéri- 
ques fonctionnent en 8 bits, il est en effet fréquent que les adresses de regis- 
tres correspondent à des octets, soit tous d’adresses paires, soit tous d'adresses 
impaires. L’instruction MOVEP permet de transférer des octets se suivant 
(dans un registre ou des mémoires) vers des adresses toutes paires ou impai- 
res. Exemple : 


lea SFFFFFAOQÏ, AO 
moveq #$0, DO 
movep.li D0,0(a0) 


(exemple tiré de la routine d’initialisation du 68901, voir Annexe 3). Cette 
séquence place 0 en $FFFFFAO1,.$FFFFFAO03, $FFFFFAOS et SFFFFFAO7. 
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EZEresse contenue dans AO avait été paire, ce sont les octets d’adresse paire 
Lx æeieni été modifiés. 

Es éthors d’un transfert rapide et économique vers les registres d’entrée- 
25, FPinsiruction MOVEP peut être utilisée par exemple pour provoquer 
2& ss graphiques. La plupart des routines de scrolling horizontal sont 
IE Tozdées sur MOVEP... 


Zion LINK et UNILK. Allocation temporaire de mémoire 


Les instructions LINK et UNLK sont sans doute les instructions les plus 
IS var les compilateurs (après MOVE tout de même)) et les moins fré- 
225 dans les programmes assembleur ! Il s’agit d'instructions de haut 
ZE (l'envers du RISC en quelque sorte), spécifiques au 68000 et autori- 
2 Femploi d'un registre d’adresse (en principe A6) comme pointeur de 
IFR, autrement dit comme une sorte de second pointeur de pile. La 
IAE ée LINK est la suivante : 


LINK An ; déplacement négatif 
:IZ À désigne un registre d'adresse, 


exécution de cette instruction, le processeur empile le contenu actuel 
2z 42 (ame nous fixerons ici à A6, comme dans tout le système TOS et GEM), 


TS Éécrémente le pointeur de pile d’une valeur égale au déplacement. Sup- 
es gar exemple que A6 = $77E00 et A7 =$7FFFS, l'instruction : 


LINK A6, $FFFO 


æËt après exécution par : A6 = $7FFF4 et A7 = $7FFE4. Le contenu 
22e =émoires $7FFE4 à $TFFF8 sera le suivant : 

STFFEA4.L quelconque (haut de la nouvelle pile) 

S-FFE8.L quelconque 

SFFEC.L quelconque 

SFFFO.L quelconque 

SEFF4.L = $77E00 (ancien contenu de A6) 

SFFFS8.L = ancien haut de la pile (souvent adresse de retour) 


= éispose ainsi de 16 octets (de $7FFFE4 à $7FFFF3) disponibles pour 
I les variables locales de la routine par exemple. Ainsi « move.w 
Sss& & SEK 26) » placera 0 en $7FFE4 et 6 en $7FFES, etc. Le registre A6 
Ze ainsi un pointeur vers la zone des variables locales (avec un déplace- 
Fe ZE gai) ET vers le contenu de l’ancienne pile (paramètres envoyés à 
ZT re par exemple). 


Z2"suction corollaire « UNLK An » placée en fin de routine permet 
227 2ter dans le registre An et le pointeur de pile A7 leurs contenus lors 
22_z7zel de LINK. Dans l’exemple ci-dessus, on aura donc A6 = $77E00 
#7 =S7FFFS8 après UNLK. 
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3.1.2. Particularités de certaines instructions 


Le 68000 se distingue par la linéarité de son jeu d’instructions et de modes 
d’adressage. La plupart des modes d’adressage sont autorisés avec les ins- 
tructions principales et des instructions proches traitent leurs opérandes de 
façon identique. Quelques exceptions existent pourtant qui, naturellement, 
occasionnent de fréquentes erreurs de programmation. Nous traiterons de 
ces exceptions après avoir rappelé quelques règles de bon sens : 

— Toute instruction traitant un registre d’adresse doit traiter celui-ci sur un 
MOT ou un LONG MOT, jamais sur un octet. 

— Toute adresse d’opérande mot ou long mot doit être PAIRE. Curieuse- 
ment le Basic fourni avec le 520 ST transgresse cette règle en autorisant 
« POKE » sur un mot ou un long mot accompagné d’une adresse impaire 
(le transfert est effectué octet par octet). Mauvaise habitude à ne pas 
prendre ! 

— Tout transfert d’une valeur dans un registre d’adresse modifie TOUT ce 
registre. Si la valeur est un entier dont le bit fort est à 0, alors le mot 
fort du registre d’adresse est mis à 0000. Sinon il est mis à $FFFF, 

— La pré-incrémentation et la post-incrémentation utilisent comme incré- 
ment ou décrément le nombre d’octets de l’opérande (1 si octet, 2 si mot, 
4 si long mot). Ainsi « move.w (A1)+,D0 » provoquera, après transfert 
du mot contenu dans (A{) dans DO une incrémentation de 2 du registre A1. 


EXCEPTION : Tout empilement d’un octet dans la pile A7 provoque 
une décrémentation de 2 du pointeur de pile. Exemple : 
move.b # 8,-—(a7) 

décrémente de 2 la pile et place $0008 sur la pile. 

— Dans l'instruction « DBRA Dn,déplacement », le nombre de branche- 
ments effectués est égal au contenu de Dn PLUS UN, puisqu'il a bouclé 
tant que Dn est différent de -1. 

— Le compteur de programme (PC) pointe toujours après le CODE de l’ins- 
truction. Ce code étant toujours de 2 octets, PC pointe 2 octets après 
le début de l’instruction. 

— L’instruction DIVS n'est pas exécutée si le quotient obtenu par la divi- 
sion ne tient pas sur 16 bits. Dans ce cas toutefois, le drapeau V du regis- 
tre d’état est mis à 1. Cette règle est aussi valable pour DIVU. 

— Les instructions arithmétiques ADD ou SUB autorisent 4 modes 
d’adressage : 


< adresse effective> registre de données Dn 
registre de données Dn <adresse effective> 
< adresse effective> registre d’adresse An 
valeur immédiate <adresse effective> 
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= Ze l'instruction CMP n'autorise pas le mode d’adresse « registre de 
IT <adresse effective> ». Autrement dit, une comparaison entre un 
TA € données et une adresse effective (registre, mémoire) doit TOU- 
ZZTES être effectuée avec le registre de données en deuxième opérande. 

— 25 Esructions logiques AND ou OR autorisent 3 modes d’adressage : 


<zäresse effective> registre de données Dn 
TEE de données Dn <adresse effective> 


Ex immédiate <adresse effective> 


x Pinstruction EOR n'autorise pas le mode d ‘adressage « < adresse 
L'ELe> registre de données ». C'est-à-dire qu’un ou exclusif ne peut être 
ET qu'entre un registre de données et une adresse effective (registre, 
Zee}. Ces deux exceptions (CMP et EOR) tiennent au partage de la 
TB p par ces deux instructions, une certaine incompatibilité de codes 


ZT =duit à ces restrictions bien gênantes. 


— Z'=section EXG, d'échange du contenu de deux registres, peut s ’appli- 
Z=æ à deux registres de données, à deux registres d’adresses ou à un registre 
Éérmée et un registre d'adresse, autrement dit l’instruction EXG Ax ,Dy 
égale (certains compilateurs l’acceptent toutefois, en la convertis- 

&= en EXG Dy,Ax). 


G2 pourra enfin regretter l'absence de certairies instructions ou options 
Æ zsecbleur 68000. Ainsi l'instruction SWAP ne permet d’échanger que 
pd 3 SOTS d’un registre de données. Elle ne peut donc s appliquer à une 


re 2 6 


= Er a drapeaux du registre d’état nécessite par aillauré l’utilisation d’un 
TEE logique AND ou OR avec le registre d’état. Pas de CLC comme 
£ zscmbleur 6809 ou 8086 ! L’absence d’une instruction DDA d’ajuste- 
= Ékimal fait également défaut mais il faut reconnaître que le jeu d’ins- 
I=É=SS 68000 est l’un des plus complets et des plus souples d'emploi. 


ET. Utilisation de fonctions externes en assembleur 


Les programmes fournis en 3.2 et 3.3 illustrent le mode d’emploi nor- 
ZE ss fonctions système (TOS et GEM) en assembleur. Ce fonctionnement 
Æ#—g'e : empilement des paramètres, appel de la fonction, remise à jour 
2. Pour utiliser une fonction dont on connaît les paramètres C, on 
2 &e d’abord le dernier paramètre, puis le précédent, et ainsi de suite 
Zen premier paramètre, Une grande attention est de rigueur quant à 
eur et au nombre des paramètres, aucune vérification n’étant effec- 
Fr P’éditeur de liens (cf. 4.1.). 
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L'un des intérêts de l’assermbleur tient à la possibilité d'appeler des fonc- 
tions non référenciées dans l’éditeur de liens (par exemple ESCAPE 101 ou 
ESCAPE 102, voir annexe 2). Là commencent les difficultés. bien que celles- 
ci soient fort surmontables. La solution réside dans l’utilisation de TRAP 
2. Toutes les fonctions GEM se ramènent en effet à l’exécution d’un TRAP 
2, avec $73 dans DO.W pour les fonctions VDI et avec $C8 dans DO.W pour 
les fonctions AES. 


Pour le stockage des paramètres d’appel on utilisera les variables de SON 
programme « contrl », « intin », « ptsin », « intout » et « ptsout » et l’on 
initialisera une table d'adresses pointant ces 5 zones de paramètres. L'adresse 
de cette table sera placée dans le registre D1.L avant l’appel de la fonction. 


Exemple : Appel de la fonction ESCAPE 102 initialisant une police de 
caractères en mode alphanumérique. 


text 
sa identif,12(a0) 
lea contrl,a0 pointe les variables de contrôle 
mOVE.W # 5,(a0] code général de la fonction ESCAPE 
cir.w 2(a0) contr! (1}=0; nbre vecteurs entrée 
cir.w 4(a0) contrl(2)=0, nbre vecteurs sortie 
move.w # 2,6(a0) contrl(3)=2, long. zone entrée 
cir.w 8(a0) contrl(4)=0, long. zone sortie 
move.w # 102,10(a0) contrl{5)= 102, code de ESCAPE 102! 
move.w identif,12(a0) contrl(6)= identif. d'application 
lea intin,aO ; pointe la zone des param. d'entrée 
move.l # police, (a0) intin(0-1} = adresse police caract. 
move.l # table,di d1= adresse table de pointeurs 
move.w $78,d0 dO =$78, code des fonctions VDI 
trap 2 exécute la fonction 
rts 

.data 1 

table de.1 # _contrl, # _intin, # _ptsin, # _intout, # _ptsout 

_contr! ds.w 12 

Lintin  ds.w 128 

_ptsin ds.w 256 

_intout ds.w 128 

_ptsout ds.w 12 

identif  ds.w 1 


police  .. ....,., (en-tête et données de la police) 


La fonction vst load_fonts permet également d'illustrer l’appel de fonc- 
tions VDI en assembleur mais de façon sensiblement différente puisque cette 
fonction a un nom à l'édition de liens. Malheureusement trois paramètres 
indispensables à son exécution ne figurent pas dans les paramètres d’appel : 
CONTRL(/), CONTRL(8-9) et CONTRL(10-11). Pour placer ces paramè- 
tres avant l’appel, on pourra utiliser la séquence suivante : 
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Mesi a6, # Sfffe pour réserver 2 octets 
PTE $A000 appel de la ligne « À » pour qu’A0 
Zovea.l 4(a0),al pointe bloc de variables 
ovea.i (al),al Al = adresse de CONTRL 
mave.l # tampeff,l4(al) CONTRL(7-8) = adr. tampon d’effets 
move.w  depeff,l8(al) CONTRL(9) = deplac. tampon 
échelle 
zove.i # police,20(al) CONTRL(10-11) = adr. de la police 
Zove.w  # 0,(a7) « select », toujours nul 
move.w  # identif, —(a7) identificateur de l’application 
= _vst_load_ fonts exécution de la fonction 
ziq.l # 4,a7 mise à jour de la pile 
k a6 pour restaurer A6 et A7 
pra 


En chéorie l'instruction de mise à jour de la pile est inutile avant l’ins- 
ze UNLK qui, de toutes façons, remet la pile dans son état lors de l'appel 
Se ZINK mais il est préférable de la conserver car qui sait si vous ne rajoute- 
-æ yes des instructions entre « addq.l 4,a7 » et « unlk a6 » ? Auquel cas 
Ls=2S remise à jour de la pile pourrait provoquer quelques surprises ! 


L'appel de fonctions AES s'effectue de la même manière mais avec 
Z=SC8 et avec D1.L égal à l’adresse d’une table d’adresses des zones de 
soctege des variables de base de l’AES. Rappelons que ces variables de base 
a dans l'ordre :_control, global, _int_in,_int_out, addr in, addr out. 
.Zss zones de variables sont naturellement distinctes des zones de variables 
ÆYDI. Quoiqu'il en soit, toutes les fonctions AES étant connues du com- 
Lzeur, leur appel s’effectuera normalement par un simple jsr (ex : jsr 
_ææï mouse), après empilement des paramètres. 


E’appel de fonctions système TOS, passant par l’emploi de TRAP 1, 
TR4P 13 ou TRAP 14, est largement détaillé en Annexe 4, Il est extrême- 
= simple en assembleur et de nombreux exemples sont fournis dans le 
Zzzemme d’initialisation d’un disque virtuel. 


&1.4. Structuration des programmes 


EL structuration est un peu la tarte à la crème des programmeurs. Ses 
== sens sont légion mais la lecture de nombreux listings prouve que les inten- 
== "ss meilleures conduisent aux embrouillaminis les plus extravagants et 
Læ cs lisibles. L'expérience montre que mieux vaut passer quelques heures 
ze Céchir au meilleur et au plus simple algorithme plutôt que de tracer soi- 
Es enr les losanges et les rectangles d’un ordinogramme dont il est pra- 

œ 
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tiquement certain que l’on s’éloignera au fil des corrections, des ajouts et 
des tests, Certaines règles générales nous paraissent cependant ne pas devoir 
être transgressées en langage assembleur (ni, le plus souvent, en langage C) : 


* La partie la plus difficile ou la plus délicate, voilà par quoi commencer 
le programme. À quoi servirait de passer des jours entiers à programmer 
le plus simple si vous ne pouvez venir à bout du plus dur ? 


| + Excepté pour les variables système ou l’adressage des circuits périphéri- 
[4 ques, n’utilisez JAMAIS d'adresses fixes. Faites comme s’il était impossi-, 
ble d’utiliser l’adressage direct. Avec le temps vous éviterez même l’emploi 
‘ de tout nombre dans la partie programme en définissant les valeurs par 
‘ l'instruction assembleur « equ ». Cette règle est transgressée dans les exem- 
. ples de programmes de ce chapitre pour des raisons de place. 

Une routine destinée à être appelée par un module extérieur doit être pré- 
cédée d’un trait de soulignement. Évitez par contre de précéder de ce trait 
les labels et noms de variables uniquement à usage interne. 

Seuls les 8 premiers caractères d’un label sont pris en compte par l’assem- 
bleur. Il est donc préférable d'identifier des routines ou des variables pro- 
ches plutôt par un suffixe que par un préfixe, contrairement à une ten- 
1 dance dominante... N'hésitez pas à utiliser les nombres dans les labels (pas 
a comme premier signe naturellement). 


L’anglais est la langue de l'informatique par excellence mais, à moins d’être ÿ 
tombé dans la Tamise quand on était petit, est-il vraiment nécessaire de 

! baptiser « handle » un identificateur ou « screen » un écran ? Les noms 

‘ les plus usités sont encore les plus parlants et aident à la correction d’erreurs. 


Toute nouvelle variable appelée dans un programme doit IMMÉDIATE- 
MENT être enregistrée dans la zone des données et répertoriée en tête du 
programme comme « .globl » si elle doit être utilisée par un autre module. 


Deux variables qui se suivent dans la liste des « .data » ne se suivront sans 
doute pas Lors de l’exécution. Tout tableau doit donc constituer un bloc. 


Une variable chaîne doit toujours être suivie d’un octet nul et d’une ins- 
t truction assembleur « .even » rétablissant la parité d’adressage. 


La tendance « naturelle » d’une boucle est d’être infinie. Vérifiez toujours 
que la ou les condition(s) de sortie seront validées quel que soit l’entrée 
dans cette boucle. 

Lors d’une routine de choix avec exécution de sous-programme selon le 
terme du choix, méfiez-vous toujours des choix non prévus, des déborde- 
ments de limites en particulier. 

Mieux vaut empiler trop de registres que pas assez ! Tout appel de sous- 
programme devrait être précédé d’une sauvegarde des registres DO à D7 


* 


+ 


+ 


x 


+ * 


+ * 


* 
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æ AGE AS, avec restitution de ces registres au retour, sauf cas particuliers 
æ —särise complète de l’assembleur. Mieux vaut ajouter des mémoires 
Éegockage temporaire de résultats que risquer de détruire le contenu d’un 


Te. 


La sie est la meilleure et la pire des choses ! Indispensable pour le pas- 
ze ées paramètres et la sauvegarde, elle est aussi à l’origine de nombreux 
+ g'enrages ». Signalez vos empilements en marge et vérifiez les dépile- 
—=s, Plus le dépilement est proche de l’empilement, mieux c’est ! 


Z= sssembleur 68000, plus de la moitié des erreurs commises et non déce- 
‘iss à l'assemblage proviennent de la confusion entre OCTET et MOT, 
SIT e LONG MOT. Mieux vaut remettre un registre de données à 0 inu- 
ni que conserver une valeur résiduelle dans le mot fort qui viendra, 
uès dans une circonstance tout à fait exceptionnelle, interférer sur tel 
= résultat. Utilisez le plus souvent possible le suffixe .W pour une ins- 
==o8 portant sur un entier bien qu’il s’agisse du suffixe par défaut, cela 

—s gidera à repérer les erreurs de taille d’opérande. Rappelez-vous que 
NTOVEQ traite toujours un long mot même si vous le faites suivre de .W ! 


= ane tâche peut être divisée en multiples sous-tâches, mieux cela vaut ! 
2 ainsi possible de réutiliser une même routine pour des objectifs par- 
Es rmtalement étrangers et, surtout, la correction des erreurs en est facilitée. 


W'=isez que les instructions et les modes d’adressage dont vous avez par- 
2%-=ment saisi le fonctionnement et les conséquences. 


Ze moniteur (SID pour l’assembleur Digital Research) est le meilleur et 
sssal ami du programmeur. Comme le testeur de l’électronicien, il cons- 
<= Poutil par excellence du « deboguage » et son utilisation doit donc 
£> aussi bien connue que celle de l’assembleur. 


L'evrée-sortie utilisateur est le calvaire du programmeur ! Tests, tests, 
==... qu’ajouter sinon que c’est toujours l'entrée au clavier incongrue 
æ-malement « imprévisible » que choisira Putilisateur.… et qui plantera 
TETE programme. 


Max vaut prendre l’utilisateur de votre programme pour un imbécile ! 
Ce qui vous paraît évident, c’est ce qui n’est pas évident... La preuve : 
rrenez un programme écrit il y a quelques années et essayer de l'utiliser 
ss mode d'emploi ! 

7 2 récursivite est rarement indispensable et toujours à éviter. Combien de 
zzacesseurs se sont perdus dans ses boucles. 


Les algorithmes les plus ringards sont souvent les plus sûrs ! Pourquoi vou- 
% wiliser un algorithme récursif de tri rapide quand un Shell-Metzner 
= mâme un tri à bulle fait correctement les choses à moindres frais, intel- 
Zswels s'entend. 
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5 «+ Un programme mal conçu et mal écrit est beaucoup plus difficile à proté- 
ger qu’un programme clair. Confusion n'implique pas complexité. 


+ Pourquoi passer tant de temps à rechercher la preuve de validité d’un algo- 
rithme s’il fonctionne (on serait tenté de dire : sa preuve, c’est qu’il 
tourne !). La fiabilité de la preuve par 9 est totale mais qui l’utilise pour 
une multiplication ? Or il n’existe pas de preuve par 9 en programmation ! 


“à * L’optimisation d’un programme est le meilleur moyen de le détruire ! Opti- * 
! misez les rares séquences ou la rapidité est vraiment indispensable ou utile 

{ (boucles à fort taux de répétition, entrée-sorties disque, etc.) mais ne pra- 
tiquez pas du retouchage. La chirurgie esthétique fait très mauvais ménage 

à avec la programmation. 


Les assertions précédentes n’engagent naturellement que leur auteur et 

chacun est libre de suivre sa voie. Elles constituent néanmoins les fruits d’une 

: expérience de programmation, ponctuée d’échecs amers mais aussi de quel- 
| ques satisfactions, dûes souvent au respect de ces règles. 


3.2. Exemple de programme : un disque virtuel 


J Le concept de disque virtuel, directement issu de la « grosse » informa- 

È tique, est encore peu usité en matière de micro-ordinateurs. Par une rapide ‘ 
Fes paraphrase, on pourrait définir le disque virtuel comme une portion de 

mémoire considérée par le système non comme une part de la mémoire vive 

mais comme un périphérique comme les autres, dans lequel il est possible 

d'effectuer des lectures et des écritures. 


Si la notion de disque virtuel est encore peu répandue, c’est bien à cause 
de son inutilité sur les micro-ordinateurs, jusqu’au 520 ST... Lorsque la 
! mémoire vive suffit à peine à contenir un programme, à quoi servirait un 
ii disque virtuel ? Avec le 520 et le 1040 ST, ce dernier modèle étant celui sur 
lequel a été écrit cet ouvrage, le disque virtuel devient par contre très intéres- 

sant, sinon indispensable, 


L'atout maître du disque virtuel c’est naturellement sa rapidité d’accès, 
considérablement plus grande que celle d’un lecteur de disquette ou même 
de disque dur. Le revers de la médaille, c’est naturellement sa volatilité (une 
coupure de courant et le disque virtuel est mort...) et son caractère éphé- 
mère puisqu'il nécessite une sauvegarde sur disque physique avant chaque 
extinction de la machine. Reste que pour des applications nécessitant de fré- 
quents accès disques comme des compilations ou des traitements de fichiers, Û 
il autorise un confort et une rapidité sans concurrence. 
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Ee programme listé et commenté dans les pages suivantes est un pro- 
ze TOS, c’est-à-dire qu’il n'utilise aucunement le GEM, contrairement 
sresramme présenté en 3.3. Il est structuré en deux parties distinctes : 
—emière, de bdpdur au premier ensemble de variables, est constituée des 
==—2ss de test du numéro de drive et des routines d'écriture et de lecture 
2 Esgue virtuel (appréhendé ici comme un disque dur à accès DMA, cf. 
——>s cherdur, lecsec et écrisec) ; la deuxième, de initdur à la fin , est cons- 
=== de la routine maître (routprin), de la routine d’initialisation du disque 
=) et des diverses routines de communication avec l’utilisateur. 


Ce disque virtuel possède un bloc catalogue de 18 secteurs (9 groupes 
2e pour les disques physiques, cf. Annexe 4, trap 1, fonction $36). Ce 
Eire empute la mémoire de 9 Ko mais il semble ne pas pouvoir être restreint 
zæs l'éat actuel du système. Naturellement un disque virtuel n’a pas à 
&e formaté, le bloc catalogue étant initialisé par la routine « initboot ». 
Te tentative de formatage se traduirait d’ailleurs par un « plantage » du 
greème qui effectuerait des actes physiques aux disques A et B avec les résul- 
ss que l’on devine ! 


Ce programme, une fois entré à l’aide d’un éditeur, sera assemblé, lié 
z:æ lui-même (!} et rendu exécutable, ce qui correspond aux commandes 
srenies avec le compilateur Digital Research (le programme source étant 
zrairement nommé « disqYirt ») : ‘ 


258 -£ b: -u -1 b:disquirt.s 
Z-&68 ‘iem(b:},u,s] b'disqvirt.68k = b:disquirt 
Ep b:disquirt : 


Le fichier objet final « disqvirt.prg » sera converti en fichier TOS par 
commande d’installation d'application du Bureau (menu « Options »). Il 
=# comporter 2047 octets. L'édition de liens du programme est assez arti- 
Salle, elle est destinée à produire le fichier intermédiaire utilisé par «rel- 
zé ». Quoi qu’il en soit, le résultat final est strictement identique au désas- 
se blage avec le listing ci-dessus, les impératifs de relogeabilité étant natu- 
£ement pris en compte. 


Au lancement, ce programme, contrairement à certains programmes de 
Æsque virtuel commercialisés, indique la capacité mémoire maximale dispo- 
Il est fort déconseillé de consacrer tout cet espace au disque virtuel. 
—5$5s l'habitude et les échecs vous conduiront rapidement à savoir combien 
Ze mémoire doit être laissée à tel ou tel programme. A titre indicatif, un édi- 
== comme « Mince » nécessite environ 140 Ko, de même qu’une compila- 
<> ou une édition de liens. Une simple soustraction vous permettra donc 
£e savoir combien de mémoire vous pouvez laisser au disque virtuel. 
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Au retour du programme, il est recommandé de cliquer une icone quel- 
conque et d’appeler l’option du menu « Installer un disque », faute de quoi 
la fenêtre correspondant au disque ne pourra pas être visualisée, On notera 
cependant que cela n’est pas obligatoire et peut être effectué à tout moment. 
On relèvera aussi qu’il est possible de créer plusieurs disques virtuels, en appe- 
lant plusieurs fois « disqvirt.prg », mais l’intérêt réel d’une telle potentialité 
n'apparaîtra qu’une fois le système d’exploitation en ROM et avec un 1040 
ou même 2080 ST... Enfin, notons qu'il est impossible de jeter le disque vir- 
tuel, de même que pour les autres icones. 


Ce programme n’est pas un modèle de programmation, il a été conçu 
essentiellement dans un but utilitaire et pédagogique. L’optimisation du code 
a été recherchée en ce qui concerne les routines de lecture et d'écriture en 
mémoire (lecsec et écrisec), la routine transec pouvant d’ailleurs être encore 
optimisée. en alignant 512 fois l'instruction « move.b (al)+, (a0)+ », mais 
au détriment de la mémoire disponible. Car, bien sûr, les routines de test, 
de lecture et d’écriture en mémoire, ne sont pas effacées après l’exécution 
de «disqvirt.prg » puisqu'elles servent à la gestion du disque virtuel ! 


AH HORAIRE EE HN HE CE OH NOK AE NOK NC ON ONG AE 
‘ * 
dvirtuel.s 


* 
* 
disaue virtuel avec choix de la taille memoire * 
laissee à l'application et de l’espace memoire * 
* 
* 
* 


HER EE 


affecte au disque virtuel, 


LEE STE TT TETE STE SET ST TEST TEE TTESETETT STE ET TETE TT 17177215 
* 


tent 
main 
bra routprin * vers programme d'installation * 
kgpdur 
move.w 4(a7),d0 * routine de pointage du bloc de * 
movea, 1 vieubdp, a0 * parametres du disque virtuel * 
lea retbhdp,ai * ou d’un disque normal (adresse * 
bra compnum * conservee dans ’vieubdp’ * 
lececdur 
TT move. w $e(a7),d0 *X routine de lecture ou ecriture * 
maovea. l vieulec, a0 * de secteur, soit du disque vir-* 
lea cherdur, ai X tuel (cherdur), soit du disque *% 
bra compnum * normal (consevee dans vieuler) * 
modedur- 
MOVE. W 4(a7),d0 * routine de demande du change- * 
movea.l vieumod, aû * ment de disque éventuel, re- * 
lea retnul, ai * tourne Ô si disque virtuel * 
compnum 
EmP.W nundriv, do * compare identificateur disque * 
bne sautrout * appele avec identificateur du %* 
movea,l at,aû * disque virtuel (numdriv) * 
sautrout 
mp (a0) * execute routine selon disque * 
retbdp 
move. li #bdpara, dO * retourne adresse bloc de para * 
rts * metres du disque virtuel * 
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aoveq 
res 


aoveq 
aove.w 
noveg.l 
asl.l 
add.1 
aovea,.l 
movea, 1 
move.w 
tstew 
beq 
cmpi.w 
bea 
bra 


ET] 


move. W 
beq 


move.b 
move, b 
move.b 
move. b 
mave.b 
move. b 
move.b 
move. b 
mave.b 
dbf 
subq.w 
bne 
retlecec 
moveq 
fiatrens 
rts 


#0, do 


#0,d0 
$c(a7),d0 
#9, di 
di,d9 
adrsto,do 
do, ao 
6ta7),al 
4(a7),d0 
do 

lecsec 
#1,d0 
ecrisec 
fintrans 


a0; ai 


10(a7),00 
retlecec 


#18, di 


(a1)+, (a0)+ 
(ai)+, (a0)+ 
(a1)+, Ca0)+ 
(a1)+, (a0)+ 
Caih+, (a0)+ 
{a13+, (a0)+ 
(a1)+, (a0)+ 
(a1)+, (a0)+ 
Ca1)+, (a0)+ 
(at)+, (a0)+ 
(a1)+, (a0)+ 
(a1)2+, (a0)+ 
Cat), (a0)+ 
(a1)+, (a0)+ 
(a1)+, (a0)+ 
{ai)+, (a0)+ 
di,transec 
#1,d0 
transfert 


#0, do 


MX x XANAX XIE XX 


x * 


#æ 


HA Ke #26 26 6 2 26 NE 26 2 6 2 26 XX 


# 2% % 5% € 


xx 


retourne 0 car disque virtuel 
ne peut avoir change... 


place dans dO le numero du 
secteur de depart a transferer 
multiplie ce numero par S12 
(nombre d’octets par secteur) 
met dans a (via d0) l'adresse 
de depart du bloc a transferer 
ai = pointeur vers tampon 

d0 = O0 si lecture.i si ecrit, 


si lecture -> lecsec 


si ecriture -> ecrisec 
sinon retour avec erreur 


echange source et destination 


do = nombre de secteurs.a lire 
ou ecrire (si nul -»> fin) 


compteur de boucie (52 fois 16) 


Cette repetition de transferts 
se justifie par le gain de ra- 
pidite obtenu : 
le transfert de 512 octets 
s'effectue en 6484 cycles ma- 
chine (soit 0.81 ms) ... 
La boucle simple : 

move.w  #511.d1 
transec 

move.b (al)+, (a0)+ 

dbf di,transec 
produit un transfert de 512 
octets en 11284 cycles, soit 
1.41 ms... 
Le gain de temps par secteur 
n’est donc pas negligeable ! 


boucle pour secteur suivant 
Jusque fin du transfert 


retour sans erreur 


bloc de parametres du disque 
virtuels: $200, soit 512 octets 
par secteur du disque, etc. 
parametres identiques a ceux 
d’un disque normal, sauf para- 
metres de taille globale. note 
dans ’koaliou’ (nombre de Ko 


disponibles sur disque virtuel) 


stockage du numero affecte au 
disque virtuel 


stock nombre octets du disque 


stock adresse page de base 


> 


MH % 326% 2% 2% x 0 2 


* 


LE 


me 2e Xe 2 6 0 M DE 6 6 36 6 D 6 À € 


* » 


* 
* 
* 
* 
* 
* 
* 
* 
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adrsto 


respile 
vieubdp 
vieulec 
vieumod 
bourrage 
* 


* 
ï initdur 


de.i 
de.l 
de.l 
dc.1 
de.l 


de. 


cir.l 


um MOVE. W 


- — 
‘ 
n i 
| 
1 
il 
‘ 
"| 
1 
l 
i 
| 
ÿ 
: * 
à routprin 
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trap 
adda.1l 


move.l 
suba.l 
move. 
or.l 
move.l 
mave.1l 
move. 
move.1l 
move.l 
move.l 
move. 1 
move. 1 
move.w 
trap 
addq.1 
move.l 
move. 1l 
1sr.l 
sub.1 
ler. 
move.w 
lea 
move.l 
move.W 
move, l 
bsr 
trap 
addq.1l 
ber 
bsr 
clr.w 
move.l 
sub.1 
add.l 
move.l 
move.w 
trap 


movea.l 
movea.1l 
move.l 
move.l 
add. 
add.1l 
add. 
move. l 
add. 
and.l 


o ds A * stock adr.depart tampon disque * 
Ô ds A * stockage temporaire de variable* 
4 * stock adresse routine demande * 
© $ ul * bloc de parametres disque norm.* 
{ * stock adresse routine ecriture * 
Ô ets A * lecture secteur normale * 
{ * stock adresse routine de test * 
6 «$ L4 * de changement de disque normal * 
0,0,0,0 ds À * quatre longs mots pour rien ! * 
Initialise Le disque virtuel * 
—(a7) 
##20,-(a7) * passage en mode superviseur * 
#1 
#6,a7 
_-#0,respile * preserve ptr pile utilisateur * 
aÿ,as * pour painter debut RAM * 
$4c2(a5),d0 * vecteur carte des disques * 
masqdr, d0 * modifie pour tenir compte du * 
d0,#$402(a5) * nouveau disque implante * 
$472(a%),vieubdp %* stocke adresses normales des * 
$476ta5),vieulee X routines relatives aux disques * 
$47e(a5),vieumod 
ibdpdur,#472{aS) * remplace dans les variables * 
Hlececdur,#476(a5) * systeme par les nouvelles * 
iimnodedur,$47eta5) * adresses de routines (utilis.) %* 
respile,-(a7) 
##20,-—(47) * retour en mode utilisateur * 
#1 
46, 47 
octallou, d0 * dO = nombre octets disque virt.* 
#9, di * divise par 512 pour obtenir le * 
di,d0 * nombre de secteurs * 
4$12,d0 * - 18 secteurs de boat’ * 
41, d0 * conversion en K octets * 
d9,koallou * stockage nombre de Ka dispon. * 
okalloc, a0 * pointe message de bon retour * 
a0,-(a7) * pour affichage * 
#9,-(a7) 
actallou, do * place dans message le nombre * 
convko * de Ko disponibles dans disque % 
#1 * Affichage du message de retour * 
#6,a7 
initboot * initialisation du ‘boot* x 
retour * Affichage du message de fin * 
-(a7) 
#initdur, dQ * Place dans dO nombre d’octets * 
#bdpdur, do * a conserver apres fin du ;5ob * 
##104,d0 * soit routines disque virtuel * 
d0,-(a7) * + 256 octets de tampon * 
HSE, — (47) * Termine l'implantation en * 
#1 * conservant octets precedants * 
* Depart reel du programme * 
a7,aë 
$4(a5),a5 * adresse de la page de base * 
añ,pilesys * sauvegardee dans pilesys * 
ce Ca5) , do 
$14(a5),d0 * d0 = adresse page de bäse + * 
$ic(a5),d0 * longueur texte + long. donnees * 
#8300,d0 0 * + longueur pile + 76B octets + 
do, di 
assdi | * di pointe sommet de la pile de * 
HsMeebEre, di * l'application (adresse paire) * 


=ez3isq 


cicen 


stocesp 


movee.} 
cove.l 
cove.}l 
Lelr.w 
aove.w 
irap 
Tädda.l 
lea 
bsr 
cire1. 
move. 
trap 
addq.il 


suba, l 
move, 
move, l 
move,l 
move. uw 
trap 

addg.1l 
lea 

move. W 
move, il 


move. l 
and.l 
beqg 
move. l 
1s1.1 
move, 
addq,w 
cmpi.w 
ble 
lea 
bra 


move, u 
add.b 
move.b 
move.l 
move.u, 
trap 
addq:1 
lea 
cmp.l 
bit 
sub. 1 
move. l 
add.i 
lea 
bsr 


lea 
bsr 
lea 
move.l 
move.b 
move.b 
move. W 


move, b 
dbra 
move w 
trap 
addq.]l 
lea 
bsr 
lea 


ä3i,a7 
d0,-(4a7) 
a5.—(a7) 
-(a7) 
#H$4a,-(a7) 
#1 

#12,a7 
entete, ao 
affiche 
—(a7) 
#520,-(a7) 
#1 

#6, a7 


a5,aÿ 
$ac2(a5),di 
di,respile 
d9,-(a7) 
4#820,-(a7) 
41 

#6, a7 
masadr, a0 
#2,numdriv 
#4, (a0) 


respile.dQ 
masqdr, dO . 
memdisq 
(a0), d0 
#1,d0 

d9, (a0) 
#1,numdriv 
#8, numdriv 
numdi sg 
plusdisq,a0 
messfin 


numdriv,d0 
#$41,dQ 
dO,okalloc+4i 
HSE, = (A7) 
##48,-(a7) 

#1 

#6,a7 
allocdef,aû 
##3000, dû 
messfin 
#$10060,d0 
dû, octallou 
##10000,d0 
combhko, a0 
convke 


combko, a0 
affiche 
chaine, a0 
a0,-(a7) 
#6, (a0)+ 
#0, (a0)+ 
#5,d1 


##20, (a0)+ 
di,stocesp 
#10,-(a7) 
#1 

#6,a7 
retcha, aû 
affiche 
chaine+1, a0 


+ # 


2% x € x 


HARXXMIXMRIX HXX  XH 


PLT LS 


3 + 


stocke longueur globale appl. * 
stocke ancien pointeur de pile * 


realloue au GEM la memoire non *# 
utilisee par 1’application * 


Affichage du panneau d’en-tete * 


passage en mode superviseur * 


pour pointer le debut de KAM * 
di = vecteur carte disques * 
sauvegarde dans respile * 


retour en mode utilisateur * 


pointeur du masque des disques * 
numero de disque par defaut(C) * 
masque correspondant (bit 2) * 


dO = vecteur carte disques 

Si numero de disque n’appar- 
tient pas au vecteur carte 
Saut en memdisq, sinon recom- 
mence avec masque pour bits 3 
a B (soit disques D a H) 


6 26 x 6 6 


Si disques C a H existent, 
affiche message "’plusdisqg” 


LES 


numero du disque virtuel 
+ code ASCII de *A° 
stocke dans message creation 


+ # 


Demande du nombre d’octets 
disponibles en memoire 
{retourne dans dû) 

pointe message d'erreur si... 
si moins de 12 Ko disponibles 
pas de disque virtuel ,., 

- 84Ko pour valeur par defaut 
stocke comme nombre par defaut 
replace le nombre à sa valeur 
pour conversion ASCII decimal 
et affichage maxi reservable 


de 4 26 26 6 6 


Affiche demande du nombre de 

Ko a reserver ,,, 

pointe debut zone de stockage 
nombre de Ko demandes et l'i- 
nitialise avec des espaces 


ex x x 


Attente d’entree d’une chaine * 
qui sera stackee a partir de * 
chaine, sur 6 caracteres maxi * 


retour de chariot pour present.* 
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Î move.l octallou,d0o * teste si chaine entree = * L 
tst.b {a0)+ * simple retour de chariot * . 
beq aliloumem * Si c'est le cas -> alloumem * 
bsr fino * Sinon conversion nombre de Ko * 
lea memtpetite,a0 * demandes en nombre hexadecimal * 
cmp.w #11,d0 * Si nombre demande <= 11 Ko * 
bis messfin * message "memtpetite* * 
move.w #10,d1 * Sinon, conversion du nombre de * 
1sl.] di,do * Ko demande en nombre d’octets * 
move.l actallou,d1 
add.1 ##10000, di * di=nombre d’octets disponibles * 
cmp.1l d1i,d0 * Si demande <= disponible * 
| bis alioumem *X -> alloumem * 
l lea memtgrande, a0 * Sinon affichage du message * 
À bsr affiche * *memtgrande’ et nouv. demande * 
} bra okmem 
4 alloumem * Alloue memoire disque virtuel * 
ï move.l * dO,octalliou 
move, ]l octallou,-(a7) * Reservation du nombre d’octrts * 
1 move. W #$48,-(a7) * demandes pour le disque virtuel* 
‘ trap #1 
adda.1 #6,a7 
D Of move. 1 d0,adrsto * Stocke ce nombre dans adrsto * 
| : tst.l d9 * Si pas erreur, installe disque * 
bne RE 
move, L #allocdef,a0 * Sinon, affichage ’allocdef” * 
; messfin 
9 bsr affiche * Affichage de ’pressez Return.."* 
| a Bstr retour 
i cir.w —(a7) *% et fin du processus sans reser-X ; 
ï | trap #1 * vation de memoire * 
L À fino 
"à moveq #0,d0 
4 4 convasc ' * Conversion de nombre en hexa, * 
nl | cmpi.b ##39, (a0) 
fr bhi fini * Si chiffre n’a pas Un code com-* 
RE il cmpi.b ##50, (a0) * pris entre 0 et 9, fin boucle * 
h bes fini 
4 mulu #10, d0 * multiplie ancien total par 10 * 
move.b (a0)+,d1 * puis y ajoute le nouveau chif- * À 
| andi,l #$6,d1 *X fre decimal * 
W à add, 1 di,d0 
bra convasc * et boucle jusque fin du nombre * 
' fini 
rts 
* 
» * Sous-programmes 
L * 
affiche * Affichage de message à l'ecran * 
{ move. 1 a0,-(a7) 
move. W #9,-—(a7) 
trap #1 
add. 1 #6,a7 
L : rts 
Î convko * Conversion d’hexa en ASCII * 
maveq.1 #10,d1 * di pour division par 1024 * 
lsr.l di,do # d0 = nombre de Ko * 
adda.l #5, a0 * a0 pointe fin de la chaine * 
move. W #4,di * nombre de chiffres pour boucle * 
nombsui 
ext.1l do * Si plus de chiffre ,fin * 
beq fini 
divs #10, d0 * Sinon, divise nombre par 10 * 
Swap do * dO0.w = reste de la division * 
move, b dO,-(a0) * stocke dans la chaine * 
addi,b #$S0, (a0) * + 550 pour code ASCII * 
swap do * dO.w = quotient ancienne div. % 
dbra di,nombsui * boucle jusque fin du nombre * 
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rts 


covea.l 
aoven.l 


sove,l 


aove.b 
dbra 

dbra 

aovea.l 
adda.i 
aove,l 
aovea, l 
adda,l 
aove,l 
rts 


lea 
bsr 


er ande de.b 
de.b 
rÆstite de.bh 
de.b 
se de. b 
TER à de.b 
Lier] 


* Initialisation du boot” * 

adrsto,a0 
#17, d0 * compteur de boucles (18) * 
#SIFF,d1 * compteur de boucles (512) * 
#0, (a0)+ + Initialise a O dix-huit blocs à* 
di,octet 4 de 512 octets, soit 9 Ko * 
d0,bloc 
adrsto, a0 # Pointe debut du boot” * 
#$200,a0 * + 512 (donc 2eme secteur) *# 
H$FIFFFEOO, (a0) * stocke *FOFFFF’ en debut de * 
adrsto, a0 * deuxieme secteur puis en debut * 
#$cO0, a0 *# de sixiema secteur * 
HSFOFFFFO0, (a0) * (pointeurs de *boot’)} * 

* Affichage du message de fin * 
pressret,a0 ni 
affiche * affiche ‘Presser Return. .* * 
#8,-(a7) * attend que la touche Return * 
#1 * soit presser... * 
#2, a7 
#15, d0 
attret 


S1b,545,13,10,9,9,9 . 

" RARE OR EEE LAN ",18,10 
ie range 
DD PU M, S1b, 870 

“ Installation de DISQUE VIRTUEL v,81B, 671 

" #",13,10,9,9,9 


GE (taille minimum = 12 Ko) *"115,10 

F5 957% #",15,10 
HURONANSESEEEEELETTTT ETES 
13,10,10,10,0 : 


9,"I1 y à deja trop de disques implantes !", 15,10 

7,"Le disque virtuel ne peut donc etre installe,..",7,0 
15,10,9 

"Allocation memoire pour le disque virtuel impossible 1,0 
15,10,10,9,"Pressez la touche ",#$1h,#70," Return ",$1b,671 
“pour retourner au Bureau, ..",0 

LPO 9 Ko reserves pour le disque virtuel C:",15,10 
F"Utilisez "Installer un disque” (option du Bureau)" L7 
15,10,9, "pour l'implantation de ce disque virtuel,.,",0 
9," © Ko disponibles pour le disque virtuel!,15,10 

9, "Combien de Ko voulez-vous reserver ?",15,10 
9,"Laissez-en un minimum Pour une application !",15,10,10 
9, "Pressez "#1b,$70, "Return", $1b, 571,13, 10 

9,"pour laisser 64 Ko à l'application "313:10,9,19 v,0 %. 
9, "Votre nombre de Ka est Superieur au nombre disponible !: 
18,10,7,0 & 

9,"Nonbre de Ko insuffisant pour un disque virtuel !" 
15,10,9, Installation non effectuee !",7,0 

6,0," n 

15,10,10,0 
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3.3, La ligne « À » 


A la conception du microprocesseur 68000, les codes binaires (que nous 
traduirons sous leur forme condensée hexadécimale) correspondant aux ins- 
tructions du processeur ont été groupés de sorte qu'aucun de ces codes ne 
commence par la séquence binaire 1010 (soit « À » en hexadécimal) ou la 
séquence binaire 1111 (soit « F » en hexadécimal), Rappelons qu’un code 
d’instruction 68000 occupe toujours deux octets (16 bits), le ou les opérande(s) 
éventuel(s) occupant deux à huit octets. Toutes les séquences de départ autres 
que « À » ou « F » sont utilisées et correspondent souvent à un ensemble 
d’instructions (ainsi la séquence « 6 » correspond à un branchement, la 
séquence « 9 » à une soustraction et la séquence « D » à une addition, etc.). 


Les codes d’instruction 68000 commencant par le quartet « À »ou« F » 
sont dits réservés mais peuvent être émulés, c’est-à-dire que lorsque le pro- 
cesseur rencontre un code d'instruction commençant par « À » ou « F », 
il se déroute vers un vecteur d'exception. Ce vecteur est placé à l’adresse 528 
pour la ligne « À » et à l’adresse $2C pour la ligne « F », A ces adresses 
doivent être placés des adresses de routines prenant en compte ces excep- 
tions. Ces routines peuvent simplement signaler l'exception où même être 
constituées d’un « RTE », elles peuvent également, à partir des bits suivant 
le quartet « À » ou « F » (donc à partir du code complet de l'instruction) 
dérouter l'exécution vers tel ou tel Sous-programme, Dans ce cas les lignes 
« À » ou/et « F » sont implementées. C’est le cas avec le 520 ST. 


La ligne « F », très particulière, fait l’objet du sous-chapitre 3.4, Nous 
nous intéresserons ici à la ligne « A », implementé par les concepteurs du 
systèrne d’exploitation dans lunique but de simplifier le travail des program- 
meurs en assembleur ! Seize codes opératoires (A000 à A00F) sont disponi- 
bles et fournissent une boîte à outils primitive mais efficace, entièrement orien- 
tée vers les fonctions graphiques fondamentales. Les routines correspondant 
aux codes d’instruction A000 à A00F constituent en fait le noyau du VDI 
et sont fréquemment appelées par les fonctions VDI classiques. 


Les instructions de ja ligne « A » ont les fonctions suivantes : 


A000 Initialisation de la ligne « À » 

A001 Fixe la valeur d’un point de l’écran 

A002 Demande la valeur d’un point de l’écran 

A003 Traçage d’une ligne entre 2 points quelconques 
A004 Traçage d’une ligne horizontale 

A005 Traçage d’un rectangle rempli 

A006 Traçage d’un polygone rempli 
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2767 Transfert d’un bloc de points 

ÆTS Écriture d’un caractère 

#9 Visualisation de la souris 

TC Non-visualisation de la souris 

768 Changement de la forme de la souris 

GC Effacement d’un spirite 

AD Dessin d’un spirite 

ÆTSE Copie (avec transformation éventuelle) de bloc de points 
ÆZ6F Remplissage de zone 


Chacune de ces fonctions fait Pobjet d’une étude détaillée dans les pages 
Eventes. Les variables et blocs de variables pointés par les paramètres de 
“our de A000 ont une importance primordiale pour le bon déroulement 
ss instructions A001 à A0OF et doivent être parfaitement compris. Le paral- 
Æme entre les fonctions de la ligne « A » et les fonctions VDI est signalé 
Zzzqu'il existe. Seule la fonction A000 à des paramètres de sortie, Toutes 
_zs fonctions, sauf A000 et A00AÀ, ont des paramètres d’entrée (cf. exemples 
Era pour l’envoi des paramètres). 


A600 : Initialisation de Ja ligne « À » 1: | 
Azcun paramètre d'appel. Paramètres de retour : 


D0.L = pointeur vers le bloc des variables de la ligne « A », 

A9.L = DO.L = pointeur vers le bloc des variables de la ligne « A ». 

AL = pointeur vers les 3 pointeurs des polices de caractères système, Î 
A2.L = pointeur vers table des 16 adresses de routines de la ligne A. 


Le pointeur retourné dans A1 sst particulièrement précieux pour l'appel 
<e la fonction VDI Escape 102 (cf. 3.1.). II peut également servir pour A008. 
Le pointeur retourné par A2 est indispensable pour une extension de la ligne 
<a À » (étudiée ultérieurement). Enfin le pointeur retourné dans DO et A0 “ 
& DÉCISIF puisqu'il permet l’utilisation des instructions A001 à AOOF. j 
L'adresse pointée est celle d’un bloc de variables, propre à l'application 
ouverte mais utilisée par le VDI, raison pour laquelle l'emploi de fonctions 
VDI et ligne « À » dans un même programme nécessite, lors de chaque appel h 
de la ligne À, une réinitialisation des variables pouvant avoir été modifiées 
par le VDI. : À 


Ce bloc comprend 122 octets. Le tableau ci-dessous récapitule les fonc- 
ons de chaque variable avec l’accès indexé hexadécimal à la variable et Le 
æom de la variable : 


S0.W plans nombre de plans vidéo (1 si haute, 2 si moyenne réso- 
lution, 4 si basse résolution). 
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octlen 


CONTRL 
INTIN 
PTSIN 
INTOUT 
PTSOUT 
vplan0 
vplani 
vplan2 
vplan3 
semlen 


masqlgn 
modecri 
x_orig 
y_orig 

x_ fin 
y_fin 
matremp 
facrep 
draremp 


semresi- 
xminres 
yminres 
xmaxres 
ymaxres” 
accucad 
pentcad 
direch 
espapol 


xcarpol 
ycarpol 
xcarec 
ycarec 


nombre d’octets par ligne vidéo ($50 si haute résolu- 
tion, $AO si moyenne ou basse résolution). 
pointeur vers la zone CONTRL (cf. VDI, annexe 2). 
pointeur vers la zone INTIN (cf. VDI, annexe 2). 
pointeur vers la zone PTSIN (cf. VDI, annexe 2). 
pointeur vers la zone INTOUT (cf. VDI, annexe 2). 
pointeur vers la zone PTSOUT (cf. VDI, annexe 2). 
valeur de la couleur de traçage pour le plan 0. 
valeur de la couleur de traçage pour le plan 1. 
valeur de la couleur de traçage pour le plan 2. 
valeur de la couleur de traçage pour le plan 3. 
drapeau de nombre de lignes à tracer (0 si une ligne, 
1 si plusieurs). Sert au système pour joindre correcte- 
ment les lignes, Inutilisé par la ligne A. Doit être mis 
à 0. 

masque pour tracé de ligne (= vsl_ style du VDI). 
mode d’écriture (étudié en A003). 

coordonnée horizontale du point de départ. 
coordonnée verticale du point de départ. 
coordonnée horizontale du point de fin. 
coordonnée verticale du point de fin. 

pointeur vers la matrice de remplissage (v. A004). 
facteur répétitif matrice de remplissage (v. A004). 
drapeau de remplissage multi-plan (0 si remplissage 
mono-plan, 1 si remplissage multi-plan). 

drapeau de restriction d’affichage (= vs_clip). 
valeur horizontale minimum affichage restreint. 
valeur verticale minimum affichage restreint. 
valeur horizontale maximum affichage restreint. 
valeur verticale maximum affichage restreint. 
accumulateur pour cadrage caractère (voir AO08). 
pente pour cadrage de caractère (voir AO08). 
direction du cadrage (voir AO08). 

drapeau de police de caractère (1 si mono-espacée, 0 
si non mono-espacée, voir v justified du VDI). 
coordonnée horiz. du caractère dans la police. 
coordonnée vert. caractère dans la police (cf. infra). 
coordonnée horizontale du caractère à l’écran. 
coordonnée verticale du caractère à l’écran. Les coor- 
données horizontale et verticale du caractère à l’écran 
pointent le coin haut gauche du caractère et non le coin 
gauche de la ligne d’écriture du bas (baseline) comme 
en VDI. 


lsrgcar largeur d’une cellule de caractère en pixels. 


beuicar hauteur d’une cellule de caractère en pixels. 

ædrpol pointeur vers l'adresse des données de la police de 
caractères utilisée (voir plus bas). 

süpol taille de la police de caractère utilisée (cf. infra). 

sylaff vecteur d’effets spéciaux (avec signification des bits 


identique au paramètre d’appel de vst_effects. Le sou- 
lignement n’est pas pris en compte. 


masquri masque pour caractère grisé (bit 1 de vst_effects). 
masqita masque pour caractère italique (bit 2 vst_ effects). 
largep largeur en pixels caractère gras (voir plus bas). 
&adroi déplacement à droite d’italique (voir plus bas). 
Hagau déplacement à gauche d’italique (voir plus bas). 
semech drapeau d'échelle (0 si pas d’échelle, 1 sinon, c’est-à- 


dire si la hauteur de caractère à afficher est différente 
de la hauteur dans la police). 


EAN vecrota vecteur de rotation de caractère (0, 900, 1800 ou 2700, 
voir vst_rotation du VDI). 
coultex couleur d'affichage du texte, 
tempeff pointe le tampon de calcul d’effets spéciaux. 
depeff déplacement par rapport au pointeur précédent du tam- 
pon de calcul d’échelle (voir A008). 
ITW coulfon couleur du fond de caractère lors d'affichage. 
FIZLMW  sypcop drapeau de type de copie de blocs de bits (0 si type 


opaque, sinon type transparent, voir VDI, vro_cpyfm 
et vrt_cpyfm). 

S'EZ adreremp pointe une routine exécutée lors du remplissage de zone 
(voir AO0F). 


Nombre de ces variables coïncident très précisément à des variables VDI 
2 L'érée des fonctions GEM (Annexe 2) permet d’en appréhender aisément 
Lasers & l'utilisation. Certaines variables sont par contre propres à la ligne 
& À » ox offrent des possibilités d'emploi supérieures, sans parler des opé- 
s plus ou moins bizarres qu’elles autorisent. Ces dernières feront donc 
TE de développements particuliers dans l’étude des fonctions qui les 


L'étude des en-têtes de polices de caractères dépasserait quelque peu le 
ee de cet ouvrage. Certaines variables y font cependant référence, aussi 
== ipimum de connaissances en la matière paraît indispensable. 


Une police de caractères peut être séparée en 3 parties : l'en-tête, qui 
2feni les variables descriptives de la police (90 octets) ; la table des dépla- 
==sms qui comporte autant de mots plus un qu’il y a de caractères dans 
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la police et qui permet de repérer le point de départ de la matrice d’un carac- 
tère donné ; les données de la police, suite de bits correspondant aux matri- 
ces de caractères, 


Les données des matrices de caractères sont ordonnées par ligne d'écran 
et non par caractère. Ainsi, pour une police 8x16 de 128 caractères, les 128 
premiers octets de données correspondront aux 128x8 = 1024 bits des lignes 
du haut des matrices des 128 caractères. Puis sera codée la deuxième ligne 
pour chaque caractère, la troisième, etc., jusqu’à la seizième et dernière. Si 
Ja matrice de caractère ne faisait que 7 points de large, 128x7 = 896 bits code- 
raient la première ligne et ainsi de suite. 


Si l’on conserve l’une des polices de caractères système lorsque l’on use 
de la ligne A (polices dont les adresses seront fournies par O(A1), 4(A1), 8(AI), 
après appel de A000), les variables nous intéressant dans la police sont les 
suivantes (déplacement par rapport à l'adresse de départ de la police) : 


$36.W  (itagau) voir vat_fontinfo du VDI. 

$38.W  (itadroi) voir vat_fontinfo du VDI. 

$3A.W  (largep) largeur de caractère gras. 

$3E.W  (masqgri) masque pour caractère grisé. 

$40.W  (masqita) masque de rotation de matrice pour italique. 

$44.L adresse de la table des déplacements. 

$4C.L  (adrpol) adresse des données de la police. 

$50.W  (tailpol) taille de la police (nombre d’octets total pour une ligne 
d’affichage de tous les caractères). 

$52.W  (hautcar) hauteur d’une matrice de caractère de la police. 


La largeur et la hauteur de la matrice de caractère peuvent naturelle- 
ment être connues par la fonction VDI vqt_attributes. La coordonnée hori- 
zontale d’un caractère dans la police, xcarpol, peut être calculée à partir de 
$44.L de l’en-tête de la police (adresse de la table de déplacements), il suffit 
d'ajouter à cette adresse : 


2 x (code ASCII du caractère — premier code ASCII de la police) 
Le premier code ASCII de la police est contenu dans $24 de l’en-tête, 


A001. Fixe la valeur d’un point de l’écran 
Appel :INTIN[0] = valeur du pixel 
PTSIN(0] =coordonnée horizontale du pixel. 
PTSIN[1| = coordonnée verticale du pixel. 


Rappelons que les tableaux CONTRE, INTIN, PTSIN, INTOUT et 
PTSOUT, sont des tableaux de mots (2 octets). Avec un moniteur monoch- 
rome, AO01 retourne 0 si le pixel est à 0 (blanc), 1 si le pixel est à 1 (noir). 


HU ON 1 
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&-= 2 couleurs, la valeur du pixel est comprise entre 0 et 3. Avec 16 cou- 
=, dle est comprise entre O et $F (voir 1.1.2 pour les couleurs 


ES 


zssrondantes). 


SLT Demande la valeur d’un point de Pécran 
5€ : PTSIN|0] = coordonnée horizontale du pixel. 
PTSIN[1] = coordonnée verticale du pixel. 


Renvoie dans DO.W ja valeur du pixel (voir A001). 


278. Traçage de ligne entre deux points quelconques 

Z=cé : indispensables x_orig = coord. horizontale de départ. 
y_orig = coord. verticale de départ. 
x_fin = coord. horizontale de fin. 
y_fin = coord. verticale de fin. 


utiles vplanO = valeur de la couleur de traçage plan 0. 


vplani = valeur de la couleur de traçage plan 1. 
vplan2 = valeur de la couleur de traçage plan 2. 
vplan3 = valeur de la couleur de traçage plan 3. 


semlgn = 0 (pour un traçage correct). 
masqlgn = masque pour tracé de ligne. 
modecri = mode d’écriture. 


Towie ligne est toujours tracée de la gauche vers Ja droite. Le masque 
esse de ligne est donc appliqué à partir du point gauche, Ce masque subit 
=szuration vers la gauche égale à : (x_fin — x_orig + 1) modulo 16. Cette 
—z" on est justifiée par la possibilité en VDI de tracer plusieurs lignes suc- 
res. Il est donc recommandé de réinitialiser masqlgn avant chaque rou- 
Ze de iracé. 


Le mode d'écriture doit impérativement être compris entre 0 et 3. Il s’agit 
Erode défini en VDI par vswr_mode. Les « valeurs de couleur de traçage » 
g’ans 0 à 3 sont égales soit à O, soit à 1. En monochrome, il suffit de 

z la variable vplanO et en 4 couleurs les variables vplanO et vplani. Les 
=== de vplan0 à vplan3 correspondent aux bits 0 à 3 de la couleur définie 
wi color en VDI (mais attention, l'appel de vsl_color ne positionne pas 
se variables vplanO à vplan3). Pour un plan donné, tout dépend du mode 
Lécure : 

— —ode REPLACE : si vplan=0, le pixel de la ligne est mis à O. Sinon, 
Le pixel de la ligne est mis à 0 ou à 1 selon le masque de ligne (masqlgn). 


— —vde TRANSPARENT : si vplan = 0, le pixel est inchangé si le masque 


<= 


4 
_ 
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est à O, il est mis à 0 si le masque est à 1. Sinon (vplan différent de O), 
le pixel est inchangé si le masque est à 0, il est mis à 1 si le masque est à 1. 


— mode XOR : vplan n'intervient pas. Si le masque est à 0, le pixel est 
inchangé. Si le masque est à 1, la valeur du pixel est inversée. 


— mode INVERSE TRANSPARENT : si vplan=0, le pixel est inchangé 
si le masque est à 1, il est mis à O si le masque est à 0. Sinon, le pixel 
est inchangé si le masque est à 1, il est mis à 1 si le masque est à 0. 


A004, Traçage d’une ligne horizontale 


Appel : indispensables x_orig = coord. horiz. point de départ. 
y_orig = coord. vert. point de départ. 
x_fin = coord. horiz. point de fin. 
ÿ_fin = coord. vert, point de fin, 


utiles vplanO = valeur de la couleur de traçage plan 0. 
vplani = valeur de la couleur de traçage plan 1. 
vplan2 = valeur de la couleur de traçage plan 2. 
vplan3 = valeur de la couleur de traçage plan 3. 
modecri = mode d'écriture (cf. vswr_mode du VDD. 
matremp = pointeur vers la matrice de remplissage. 
facrep = masque de la matrice de remplissage. 
draremp = drapeau de remplissage (0 = monoplan). 


On pourrait croire que le traçage d’une ligne horizontale ne constitue 
qu’un cas particulier et simplifié du traçage d’une ligne. Or c’est l’inverse ! 
Le traçage de ligne horizontale constitue en fait une sous-routine utilisée par 
les fonctions de remplissage, d’où l’influence de matremp, facrep et draremp. 


Les matrices de remplissage, définies par les fonctions VDI vsf_interior, 
vsf_style et vsf_udpat, appartiennent aux fonctions les plus obscures, et natu- 
rellement, les moins utilisées du GEM, Aussi paraît-il utile de rentrer ici un 
peu dans les détails : 


— L’'instruction vsf_interior définit un type de remplissage. Avec le para- 
mètre d’appel 2, elle définit le style « matrice » auquel nous nous inté- 
ressons ici. 

— L'instruction vsf_style, dès lors que le type « matrice » a été choisi, défi- 

nit un type de matrice (matrice pointillée si style — 4, pleine si style = 8, 

briques si style = 9, etc.). La matrice système ainsi définie est une matrice 

de 16 pixels + x pixels (ou x= facrep), recopiée autant de fois que nécessaire. 

Si l’on travaille avec un moniteur couleur, cette matrice sera sur 2 ou 4 plans 

selon le mode, autrement dit comportera 2 ou 4 fois (16 + x bits). Les seize 

premiers bits (sur un ou plusieurs plans) définissent la matrice pour 16 pixels 
d’une ligne d'écran, les seize suivants pour la ligne d’en-dessous, etc. 
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— TEsrection vsf udpat permet de définir sa propre matrice de remplis- 
22, lequeile doit comporter 16 mots pour chaque plan, selon le prin- 
Ze décrit ci-dessus. : 


=raruction A004, de même que les instructions A005, A006 et AOOF, 
ses le matrice de remplissage. Si celle-ci n’est pas initialisée par le pro- 
==, la dernière matrice définie par vsf_interior et vsf_style est valide. 
Fr style et aucune matrice n’a été définie même à l'appel de v_opnvwk 
2 INHINY7] et INTIN(8)), le style est défini à 0 par défaut. 


Le drapeau draremp est simplement associé à la résolution mono ou 
"sn de l'écran, Par contre facrep, facteur répétitif de la matrice de 
esse, est une variable système intéressante. Elle définit le nombre de 
Ts de la matrice, c’est-à-dire le nombre de lignes moins une après lesquelles 
ez2:5$ initial est repris. On a : 

3 (4 lignes) si vsf_interior = 2 et vsf_ style < 8. 
7 (8 lignes) si vsf_interior = 2 et vsf style >= 8, 
ou vsf_interior = 3 et vsf style < 6. 
= = 15 (16 lignes) si vsf_interior = 3 et vsf style >= 6, 
ou vsf_interior = 4 (style utilisateur). 


Grêce à la ligne À, il est toutefois possible de modifier le facrep pour 
—2—2rice système. Il est surtout possible de fabriquer une matrice de rem- 
—ssse avec un facteur répétitif quelconque, par exemple de 32 ou 48 lignes 
Se=zeur, Il suffit de placer l’adresse de sa matrice dans matremp, de posi- 
=== le drapeau de mono-plan selon la résolution employée et de placer 
æ2z7-bre de lignes —1 de la matrice dans facrep. 


S vous désirez utiliser une matrice de remplissage système conjointe- 
== à la ligne « À », il est nécessaire d’utiliser les fonctions VDI vsf_inte- 
= æ vsf style, aucune instruction de la ligne « A » ne le permettant. Maïs, 
SITENTION, la matrice n’est réellement initialisée et disponible pour la 
=a À » que lorsqu'une fonction VDI a été appelée APRÈS les fonctions 
5 érior et vsf_style. Une méthode qui en vaut une autre consiste à appe- 
æ am fois de suite vsf_ style. Naturellement, une initialisation de matrice 
—smeur, une fois appelé vsf_interior avec le mode 4, peut s’effectuer en 
zsscmbleur sans passer par vsf_udpat.… 


4765. Traçage d’un rectangle rempli. 

Az51 : indispensables x_orig = Coord. horiz. d’un sommet. 
y_orig = coord. vert. d’un sommet. 
x_fin = coord. horiz. du sommet opposé. 
y_fin = coord. vert. du sommet opposé. 
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utiles vplanO = valeur de la couleur pour le plan O. 
vplan! = valeur de la couleur pour le plan 1. 
vplan2 = valeur de la couleur pour le plan 2. 
vplan3 = valeur de la couleur pour le plan 3. 
modecri = mode d'écriture (cf. vswr_mode). 
matemp = pointe la matrice de remplissage. 
facrep = facteur de répétition de la matrice. 
draremp = drapeau de remplissage mono-plan. 
semrest = drapeau de restriction d’affichage. 
xminres = minimum horizontal affichage restreint. 
yminres = minimum vertical affichage restreint. 
xmaxres = maximum horizontal affichage restreint. 
ymaxres = maximum vertical affichage restreint. 


(] 


Les variables de remplissage et de mode d'écriture fonctionnent comme 
décrit pour A004. Le drapeau semrest correspond au mode de vs_clip. Soit 
il est à 0 et aucune restriction d’affichage n’existe, soit il est à 1 et le rectan- 
gle tracé sera égal à l'intersection du rectangle dont les deux sommets oppo- 
sés sont fournis et du rectangle restreint défini par xminres, yminres, xmax- 
res et ymaxres. 


A006. Traçage d’une ligne écran d’un polygone rempli. 


Appel : indispensables CONTRL{1] = nombre de vecteurs. 
PTSIN [|] = zone des vecteurs. 
y_orig = coord. vert. de la ligne. 


utiles vplanO = valeur de la couleur pour le plan 0. 
vplani = valeur de la couleur pour le plan Î. 
vplan2 = valeur de la couleur pour le plan 2. 
vplan3 = valeur de la couleur pour le plan 3. 
modecri = mode d’écriture (voir vswr_mode). 
matremp = pointeur de matrice de remplissage. 
facrep = facteur de répétition du remplissage. 
draremp = drapeau mono ou multi-plan. 
semrest = drapeau d’affichage restreint. 
xminres = coord. hor. minimum d’affichage restreint. 
yminres = coord. vert. minimum affichage restreint. 
xmaxres = coord. hor. maximum affichage restreint. 
ymaxres = coord. vert. maximum affichage restreint. 


Le polygone à remplir est défini par un certain nombre de vecteurs, c’est- 
à-dire de coordonnées (xl, yi), (x2, y2), … (xn, yn), (xl, y1). Le nombre 
de ces vecteurs est placé dans CONTRL{1]. On notera que ce polygone est 
fermé, le premier point étant aussi le dernier. L’instruction A006 trace une 
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TS Fées de ce polygone. Cette ligne peut être composée d’un ou plu- 
ZE mis selon les coordonnées des vecteurs, elle peut même être nulle 
2 ZT onnée verticale sort du domaine du polygone. Pour remplir entiè- 
EE  5olygone, il faut boucler en décrémentant y_orig de l’ordonnée 
2 = Ezxe du polygone à la plus basse. 


ET Transfert d’un bloc de bits 
2ZTE : A6 doit pointer sur un tampon de 76 octets ou : 


SUK(A6).W = largeur du bloc en points. 

S2(46).W = hauteur du bloc en points. 

S4{A6).W = nombre de plans de la destination. 
S6(46).W =index de couleur pour 0 (cf. vrt_cpyfm). 
SS(A6).W = index de couleur pour 1 (cf. vrt_cpyfm). 
SA(A6).B = mode de transfert (voir plus bas). 


SB(A6).B = $C si REPLACE, $D si REVERSE TRANSPARENT, 
” © dans les autres modes. 

SC(A6).B = 53 si REPLACE, $7 si TRANSPARENT, 0 sinon. 

SD(A6).B = $F si REPLACE, 0 sinon. 

SE(A6).W = origine horizontale du bloc source. 

S10(A6).W = origine verticale du bloc source. 

S12(A6).L = pointeur mémoire MFDB source (cf. infra). 

Si6(A6).W =2 x nombre de plans de la source. 

S18(A6).W = nombre d’octets par ligne d’écran pour source. 

SIA(A6).W = O0 si mode vro cpyfm, 2 si mode 

o vrt_cpyfm. 
SiC(A6).W = origine horizontale du bloc destination. 


SIE(A6).W = origine verticale du bloc destination. 

S20(A6).L = pointeur mémoire MFDB destination (cf. infra). 
S24(A6).W = 2 + nombre de plans de la destination, 

S26(A6).W = nombre d’octets par ligne d’écran pour dest. 
S28(A6).W = 2 dans tous les cas. 

S2A(A6).L = matremp (adresse matrice de et 0 si non 


prise en compte. 
S2E(A6).W = 2 si matremp non nul, 0 sinon. 
S30(46).W = 0 si matrice mono-plan, $20 si multi-plan. 
$ S32(A6).W = facrep, facteur de répétition du motif, 
s S34(A6) à $4B(A6) doivent être nuls. 


2 transfert de bloc de bits copie un bloc de bits d’une source vers une 

s 2 sion. Le bloc source et le bloc destination ont la même taille, La copie 
7e à effectuée en mode vro_cpyfm ou vrt_cpyfm, avec un mode de trans- 

[sr iogique inférieur à 4 en mode vrt cpyfm et quelconque en mode 


TT CNE : 
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0 place tous les pixels du bloc de destination à 0. 


1 résultat = ET logique entre état source et état destination. 

2 résultat = ET logique entre état source et inverse état destination. 

3 résultat = état de la source (mode REPLACE). 

4 résultat = ET logique entre inverse état source et état destination. 

5 résultat = état de la destination. 

6 résultat = OU exclusif entre source et dest. (mode XOR). 

7 résultat = OÙ logique entre source et destination (TRANSPARENT). 

8 résultat  — inverse de (source OU destination). 

9 résultat  — inverse de (source XOR destination). 

A résultat = inverse de l’état de la destination. 

B résultat — source OÙ (inverse de la destination). 

C résultat = inverse de la source. 

D résultat = (inverse de la source) OÙ destination (INVERSE 
TRANSPARENT). 

E résultat = inverse de (source ET destination). 


F place tous les pixels du bloc de destination à 1. 


Un bloc de mémoire MFDB est une structure décrivant un ensemble de 
bits. Cette structure est d’ailleurs implementée dans le compilateur C de Digital 
Research sous l’appellation FDB. Nous fournirons donc ici sa description 
en tant que structure C (fichier à inclure : GEMDEFS.H) : 


long fd_addr adresse de départ du bloc de points. 
int fd w largeur en pixels du bloc de points. 
int fdh hauteur en pixels du bloc de points. 
int fd wdwidth largeur en mofs du bloc de points. 
int fd stand 0 si dépend du périphérique, 1 sinon. 
int fd_nplanes nombre de plans vidéo (1, 2 ou 4). 
int fdri réservé (0 en principe). 

int fd_r2 réservé (0 en principe). 

int fdr3 réservé (0 en principe). 


L'instruction A007 est spécifique de la ligne « A », elle correspond à 
la primitive de base du remplissage de forme. Son intérêt tient aux possibili- 
tés offertes par la manipulation des modes autorisés et surtout par la possi- 
ble utilisation de matrice de remplissage faisant office de masque. Il est même 
envisageable, en falsifiant les données sur le nombre de plans, de simuler 
des effets de dédoublement d’image ou autres effets spéciaux tout à fait irréa- 
lisables en C. 


A008. Écriture d’un caractère 


Appel : 
indispensables modecri = mode d'écriture (0 à $13). 
xcarpol = coord. horiz. du caractère police. 
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ycarpol = coord. vert. du caractère police. 
xCarec = coord. horiz. du caractère écran. 
yecran = coord. vert. du caractère écran. 
adrpol = adresse de la police de caractères. 
taïlpol = taille de la police de caractères. 
coultex = couleur du texte affiché. 
coulfon = couleur du fond de caractère. 
miles accucad = accumulateur pour cadrage de caractère, 
pentcad = pente pour cadrage de caractère. 
direch = direction du cadrage de caractère. 
largcar = largeur du caractère en pixels. 
hautcar = hauteur du caractère en pixels. 
stylaff = style d'affichage. 
masqgri = masque pour caractère grisé. 
masqita = masque pour-caractère italique. 
largep = taille pour épaississement de caractère. 
itadroi = déplacement à droite pour italique. 
itagau = déplacement à gauche pour italique. 
semech = drapeau d’échelle. 
vecrota = vecteur de rotation du caractère. 
tampeff — adresse du tampon d'effets spéciaux. 
depeff = déplacement du tampon d’échelle. 


Z'Emération ci-dessus des variables « indispensables » et « utiles » 
T2 Éreyer le lecteur. Elle n’a pourtant rien que d’ordinaire si l’on con- 
ze 7= Le définition de ces variables remplace l'exécution d’une bonne 
2 é8 fonctions VDI. Il est en effet possible grâce à l'instruction A008 
22 £=5e de police de caractères, de hauteur, de largeur, de couleur, de 
TZ Sécimre, de coordonnées ou de direction d’affichage pour un seul carac- 
2e Il est naturellement possible de ne pas en changer en ne modi- 
2 75 les valeurs correspondantes des variables. 

—e cadrage et l'échelle font référence à vst_height et vst _point du VDI. 
-z= =odification de la hauteur du caractère par rapport à la hauteur de 
ZE dass la police nécessite un ajustement pour affichage par le système. 
Zz #=sement portant sur la largeur et la hauteur, les variables accucad, 
723, direch et semech permettent cet ajustement. La variable semech est 
#2 + a ajustement, la variable direch est à O s’il y a réduction de taille, 
5 2 augmentation de taille. L’accumulateur accuad devra être initia- 
= € $5000 avant un appel de A008 utilisant l’échelle. La variable pentcad 
—=Sp02d au facteur d’ajustement. S’il y a augmentation de taille : 


4hs dt 


pemcad = 256 + (taille voulue - taille actuelle)/taille actuelle, S’il ya 
Ton de taille : 
Dpenicad = 256 + taille voulue / taille actuelle. 
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A009. Visualisation de la souris 
Appel : INTIN [0] : Force la visualisation si nul. 


Fonction strictement identique à v_ show _c en VDI. 


Remarque : Toute demande de visualisation ou de non-visualisation de 
la souris provoque une incrémentation ou une décrémentation d’un comp- 
teur. Si ce compteur est nul, une demande de visualisation est valide et le 
compteur passe à 1. S’il n’est pas nul, la demande de visualisation n’est pas 
prise en compte mais le compteur est incrémenté. Par contre, une demande 
de non-visualisation est toujours prise en compte et provoque l'effacement 
de la souris avec décrémentation du compteur. Le paramètre d’appel INTIN[0] 
permet de réinitialiser ce compteur. 


A00A. Non-visualisation de la souris 


Aucun paramètre d’appel ou de sortie, Comme expliqué ci-dessus, une 
demande de non-visualisation, alors que la souris est déjà invisible, provo- 
que une décrémentation du compteur, de sorte que la demande de visualisa- 
tion suivante ne sera pas prise en compte sauf si INTIN(0] = 0. 


A00B. Changement de Ja forme de la souris 
Appel : INTIN(O] = coord. horiz. sommet gauche de la forme. 


INTIN|1] = coord. vert. sommet gauche de la forme. 
INTIN/2] = 1. ï 
INTIN/3| = couleur du masque (normalement 0). 


INTIN(4] = couleur des données (normalement 1). 
INTIN(5] à INTIN(20| = masque de la forme (16 mots). 
INTIN/21] à INTIN(36} = données de la forme (16 mots). 


Instruction identique à vsc_form en VDI. La notion de données et de 
masque d’une forme tient à la nécessité de visualiser la souris quelque soit 
le fond de l’écran. Ainsi pour la forme de souris flèche, les données corres- 
pondent à la flèche (bits mis à la couleur de INTIN{3]) et le masque corres- 
pond à un cadre d’un pixel de large auréolant la flèche (bits mis à la couleur 
de INTIN{4}). Ainsi une flèche noire est-elle visible sur fond noir à cause de 
son auréole blanche (son « masque »). Seuls les bits à 1 dans les données 
et le masque sont pris en compte lors de l’affichage. 


Comme vsc_form, l'instruction A00B change la forme mais ne provo- 
que pas une visualisation de la souris si celle-ci est cachée. 


A00C. Effacement d’un spirite 


Appel : A2 = pointe vers un tampon de sauvegarde de 10 octets + 64 octets 
par plan vidéo minimum. 
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TI éessous pour l'analyse du « spiritisme ». 
ED. Dessin d’un spirite 
2e : D0.W =coord. horiz. sommet gauche du spirite à tracer. 
DI.W = coord. vert. sommet gauche du spirite à tracer. 


#9.L = pointeur vers le bloc de définition du spirite, 
#2.L = pointeur vers le tampon de sauvegarde du spirite, 


Le Enc de définition pointé par AO à la structure suivante : 


@-W déplacement horizontal soustrait à la coord. avant affichage. 
2.W déplacement vertical soustrait à la coord. avant affichage. 
4.W type d'affichage (positif ou négatif) 


©&7l. données coul. masque positif négatif 
0 0 sans effet sans effet 
0 1 coul. masque coul. masque 
1 0 coul. données xor avec écran 
1 1 coul. données coul. données 


6.W couleur du masque 

8.W couleur des données 

10.W à 5F 32 mots définissant l’image entrelacée du spirite : 
mot 0 = ligne 0 du masque, mot 1 = ligne 0 des données, 
mot 2 = ligne 1 du masque, mot 3 = ligne 1 des données, ….) 


Tes routines de dessin et d’effacement de spirite constituent en fait des 
Is générales, utilisées par le GEM pour redessiner le pointeur de souris 
-& = Fon déplace celle-ci, Lors d’un déplacement de la souris dépassant 
air seuil (voir 5.2), le circuit clavier génère une interruption, laquelle 
Tage l'exécution d’une routine qui stocke les nouvelles coordonnées de 
Zxis et met un drapeau à 1. À chaque interruption balayage vidéo (70 
rs 5æ seconde en monochrome), ce drapeau est testé et s’il est placé, une 
TI est exécutée, laquelle recupère dans le bloc de sauvegarde (pointe par 
37 Sans A00C et A00D) le contenu bit à bit de la zone recouverte par la 
ÆTSS, le replace sur l'écran, sauvegarde la partie de l’écran qui va être recou- 
“&= per la souris et, enfin, affiche la souris. La primitive A0OC est consti- 
= de l'affichage de l’ancienne zone sauvegardée. La primitive A00D est 
2 Huée de la sauvegarde de la zone qui va être recouverte et de l'affichage 
2 sHrite. 


Ces routines permettent de gérer l'affichage et donc le déplacement de 
= wne myriade de spirites, surtout si l’on utilise la routine d'interruption 
Zesyage pour générer cet affichage (cf. chapitre 5). 
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AO00E. Copie d’une forme FDB. 


Appel : CONTRL{7-8] = adresse du bloc source FDB. 
CONTRL{9-10] = adresse du bloc destination FDB. 


INTIN(0] = mode d'écriture, 

INTIN{1] = couleur affectée aux bits à 1. 

INTIN{2] = couleur affectée aux bits à O. 

PTSIN(0] = coord. horiz. du sommet de la source. 
PTSIN{(1] = coord. vert. du sommet de la source. 
PTSIN{2] = coord. horiz. du sommet opposé de la source. 
PTSIN{3l = coord. vert. du sommet opposé de la source. 
PTSIN{4] = coord. horiz. du sommet de la destination. 
PTSIN{5] = coord. vert. du sommet de la destination 
PTSIN{6] = coord. horiz. du sommet opposé de la dest. 
PTSIN(7| = coord. vert. du sommet opposé de la dest. 


typcop = 0 si mode vro cpyfm,--1 si mode vrt_cpyfm. 


INTIN{1] et INTIN{2] ne doivent être définis que lorsque l’on veut effec- 
tuer une copie similaire à vrt cpyfm. Cette instruction constitue 
en effet la primitive commune à vro_cpyfm et vrt_cpyfm, elle permet de 
transférer un bloc de bits avec modification éventuelle de ce bloc (selon Le 
mode d’écriture) et de sa taille. 


Comme pour l’instruction A007, il est possible de jouer sur les matrices 
de remplissage et sur le drapeau de mode d'écriture pour obtenir des effets 
peu ordinaires à l’affichage. 


A00F. Remplissage de zone. 
Rappel : INTIN{0] = couleur de contour. 
PTSIN(0] = coord. horiz. point de départ du remplissage. 
PTSIN{1] = coord. vert. point de départ du remplissage, 
adrcremp = adresse de routine d’arrêt de remplissage. 
L'instruction AOOF correspond à la primitive de v_contourfill en VDI. 
Si la couleur de contour est négative, l'algorithme de remplissage sélectionne 
comme couleur de contour toute couleur différente de la couleur du pixel 
de départ. Sinon il n’y a remplissage que si la couleur de contour est dif- 
férente de la couleur du pixel de départ. Rappelons que la fonction v._con- 
tourfill utilise les attributs habituels du remplissage (matrice éventuel- 
le, couleur, etc.). 

L’instruction AO0F ajoute une possibilité supplémentaire à v_contourfill. 
On peut, par adrcremp, stopper le remplissage après une ligne donnée. Après 
chaque traçage de ligne, la routine AOOF exécute en effet le sous-programme 
d'adresse contenue dans adrcremp. Soit cette routine renvoie 0 dans DO (cas 
de la routine système) et le remplissage se poursuit, soit elle renvoie une valeur 
non nulle dans DO et le remplissage est stoppé. 
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Tout programmeur peut donc, en utilisant l’instruction AOOF, stopper 
eremplissage, par exemple lorsqu'une certaine hauteur est atteinte, lorsqu'un 
= temps est dépassé, lorsqu'une touche est appuyée. ATTENTION, dans 
ss les cas adrcremp doit pointer sur une routine, qui sera au minimum : 


moveq.l # 0,d0 
Hs 


Exemple d'utilisation de la ligne « À » 

Le programme ci-dessous utilise plusieurs instructions de la ligne « À », 
&svoir A000, A003, A009, AO0A et AOOF. Tout programmeur confirmé 
Ze trouvera d’une simplicité limpide, quelques précisions paraissent cepen- 
Le utiles même si le listing est largement commenté : 


— Ce programme n’a qu’une fonction : effacer l’écran et afficher un 
« camembert » partagé en huit secteurs de même taille, Ces secteurs sont 
remplis avec des matrices différentes. Une attente d’entrée clavier suit 
Paffichage, avant retour au Bureau GEM. 

— Pour effectuer cette tâche, le programme utilise des fonctions VDI, un 
Trap système et des instructions de la ligne « À ».. Abondance de biens 
ne nuit pas ! Cette courte application est donc une application GEM, con- 
trairement au programme de disque virtuel présenté en 3.2. 

— Le lecteur attentif notera que l’utilisation d’une instruction de la ligne 
« A » comporte une initialisation réduite au minimum. Nombre de para- 
mètres de la ligne « À » n’ont en effet pas besoin d’être réinitialisés, à 
partir du moment où l’on est certain de leur état, ce qui suppose d’avoir 
bien assimilé le mode d’emploi de la ligne « À » et du VDI et les résul- 
tats d’exécution. 

— Pour les utilisateurs du compilateur Digital Research, voici les comman- 
des nécessaires pour assembler et exécuter l’édition de liens (le programme 
source étant appelé « camembert.s » et placé sur le lecteur B) : as68 
-f b: -u -1 b: camembert.s 
link68 |tem[b:],u,s | b:camembert.68k = gemstart,b:camembert, vdibind, 
gemlib 
relmod b:camembert 

Le fichier objet produit s’appellera naturellement « camembert.prg-» 

& sera exécutable par double cliquage. On relèvera que seul vdibind est lié 

au programme, aucun appel de fonction AES r’étant effectué par l’applica- 

#on, qui n’a pas besoin non plus de libf, librairie mathématique. 
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.globl 

-olobl 
} .9labl 
# à .globl 
} -globl 
' -globl 
text 
main 


ppar ent 


' bouctra 
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main 
_contri 
intin 
_Ptsin 
_intout 
_ptsout 


lea 
movea. 1 
moveq 


MOVE. W 
dbra 
moveq 
move.W 
move.w 
move. } 
move.1l 
move. 1! 
sr 
adda,1 
move. W 
jsr 
addq.1l 
move.w 
move, 
move, W 
move.w 
move.w 
move, 
ser 
adda.l 
de.w 
move. l 
movea, 1 
movea, l 
moven,! 
move. ! 
move. l 
move, 1 
move. w 
mave.w 
move. w 
sr 
adda.i 
movea. l 
move.w 
move. w 
move. l 
lea 
moveq 


move. 
move.W 
movem, 1 
de.w 
movem. 1 
dbra 
moveq 
move. l 


* declaration obligatoire de main 
k et des variables de base du VDI 
* pour une edition de liens cor 
* recte avec le programme cemstart 
*# et la bibliotheque GEM et VDI, 


6 6 6 26 


par_entsa0 * pointe la zone des parametres * 
a9, ai * d’entree pour v_opnvwk. dans * 
#11,d0 * laquelle sont stockes douze 1 * 
41, (a0)+ 

do,ppar_ent 

42, d0 *X remplace le style de remplis- * 
d0,14(a1) * sage interieur par 2, soit le * 
dG,20(a1) * style matrice et definit le * 
#par_sort,-(a7) * svsteme de coordonnees (RC) * 
#identif,-(a7) 

#par_ent.-(a7) - 

_vopnvwk *% initialise l'application * 
#12,a7 

identif,-(a7) * identificateur de l’application 
VELrWR * effacement de l'ecran 

#2,a7 

#354600,-(a7) * angle de fin : 560 degres 
#0,—(a7) * angle de depart : © degre 
#100,-(a7) * rayon de l'arc : 100 pixels 
#200.—(a7) * ordannee du centre : 200 
#320,-(a7) * abcisse du centre : 220 
identif.-(a7) 

arc * tracage de l’arc 

#12,a7 

$A000 * APPEL de la LIGNE "a" 

d0, varligna * stocke adresse bloc variables 
4(a0) ,aS *X aS = adresse de CONTRL ligne "A" 
8(a0),a4 * a4 = adresse de INTIN ligne "A" 
$c(a0),a5 * aS = adresse de PTSIN ligne "A" 
#riens—(a7) * "rien" parce qu’une adresse est 
#rien,-(a7) * necessaire .., 

#rien.-(a7) 

#T20, -(a7) * ordonnee puis abcisse de la * 
#540,—(a7) * souris definies en 520.540 * 
ddentif,-(a7) 

_vra_locator 

#18,a7 

varligna, a0 * adresse du bloc var. ligne 
#520. 526 (a0) * #_orio 320 

#200. 528 (a0) * vorig 200 

fretnorm,$7é6(a0) + stocke une fois pour toutes l'a- 
speccoor al * dresse de retnorm pour rempliss. 
#7,d47 # compteur de boucle 

(a1)+,$2a (a0) * stocke #_fin de la ligne  * 
(a1)+,#2c (a0) * stocke y_fin de la ligne * 
d7/aûü-ai.-(a7) * pour sauver les pointeurs * 
+AOÔS *% TRACAGE DE LIGNE * 
(a7)+,d7/a0-a1 * restitue les pointeurs x 
d7,bouctra * etc. pour les € lignes * 
#7, 47 * nouveau compteur de boucle * 
ats-(a7) * sauve le pointeu- de param. * 


2 


MHMMAENXIE 2% 28% 


CEETE 


= =en 
moveq #0, dé * compteur de boucle ! * ] 
move. W d7,-{(a7) *X sauve premier compteur * 
move.w {a7);(a7) * empile compteur de remplissage * ï 
addi.w #14, (a7) * pour definir le style (21 a 14) *X 
move W identif,-(a7} *X identificateur d'application * 
isr -vsf_style * definit le style de remplissage * à 
addq.1l #4,a7 * et recommence une autre fois... * 
dbra dé,reapstyle * pour prise en compte * ï 
move. W #i, (a4) * INTINLO] = 1, couleur du cadre * \ 
movea,.l 2(a7),al * recupere le pointe de param. À | 
move. wW Cai)+, (45) x stocke abcisse puis ordonnee du * 
move. w (a1)+,2(aS) * point de depart du remplissage * 
move.l ai,2{ta7) * mise a jour ptr de parametres * l 
de.w $AQ0F * REMPLISSAGE DE FORME * 1 
MOVEAW (a7)+,d7 * restaure compteur de boucles * À 
dira d7,boucfon *X recommence pour les 8 secteurs * | 
movea. L (a7)+,ai * pour mise a jour de la pile * i 
move. W #0, (ag) * INTINCOJ=0, reset souris * { 
de.w $A009 * VISUALISATION DE LA SOURIS * ‘ 
+ move. W #2,-(a7) * peripherique = clavier * 
+ move, W #2,-(a7) * fonction = Bconin() L 
trap #15 * attente d’entres tlavier * 
% eddq.1l #4,a7 * restitue la pile * 
+ de,w $A00A * NON-VISUALISATION DE LA SOURIS * 
4 move.w identif,-(a7) *% identificateur de l'application * 
" 357 _v_cisvwk * sort de l'application * 
£ adda,) #2, a7 * mise à jour de la pile * 
rts _ * et retour au Rureau... * 
n Tester a 
moveq #0,d0 * routine executee a chaque rem-  * 
# rts * plissage de nouvelle ligne * 
Séta 
à ae _ent ds.w 12 * parametres d’entree v_opnywk * 
k =er_sort ds,w 57 * parametres de sortie v_opnywk * 
* ds.w 1 * pour stocker l1’identificateur * 
+ dsl El * pour stocker n'importe quoi! * Î 
* ds.1 4 * pour stocker adresse bloc var. * 
ï ds.w 12 * zones de stockage obligatoires * 
dsew 128 * paur utilisation du GEM, puis * 
ds.w 256 * coordanneas des points de fin * 
ds.w 128 * de ligne et de remplissage * 
ds.w 12 
de.w 220,200,250, 130,520, 100,390, 150 
+ de.w 420, 200,390, 270,320, 300, 250,270 
k de.w 270,190,270, 130,370, 150,370, 190 
4 de.w 370,210,570,270,270,270,270,210 
k «cé l 
+ 
| 
( 
l 
L 
ÿ 
\ 
| 
| 
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3.4. Abuser de la ligne « À », user de la ligne « F » 


Il est tout à fait envisageable de détourner la ligne « À » à son seul pro- 
fit, en modifiant l’adresse placée en $28.L, adresse pointant vers la routine 
système de tri de la ligne « À », et en y placant l’adresse d’une routine « mai- 
son » qui pratique le tri entre vos propres instructions « À ».. Mais il sem- 
ble plus intéressant de détourner seulement cette ligne, conservant ainsi seize 
instructions (A000 à A00F) dont le bon fonctionnement est du moins garanti ! 
Pour pratiquer ce détournement, il faut écrire une routine de tri semblable 
à celui-ci : 


inter“a" 
ñovea.l $2(a7),a0 * a0 = FC lors de V’interruptian # 
move.w  (a0),d0 + d0 = code de l'instruction "A" % 
andw H$Fff, 40 * supprime le quartet "A" commun * 
addq.l 4#2,2(a7) . ainsi PC pointe après instruct, * 
cmpi.w HS$$,dO + Si code instruction > AG0F, * 
bhi personnel *# aller au tri personnel * 
movea.l adtable, 30 * a0 pointe la table des rautines # 
bra commun * système Ligne "A", retournèe * 
personnel * dans A2 à l'appel de A000 * 
sub,w  H$10,d0 * si code > A00F , le compare au à 
Enp.u  dÜ,maxiligna * code maxi stocke par vous dans + 
bhi retour * "matiligna", Si >, fin * 
movea,l adtpers, a0 4 sinon a0 painte la table de vos 
commun + adresses de routines x 
1sl.w  #2,d0 * x 4 pour déplacement dans table * 
movea.l 0{20,d0),a1 + ai = adresse dans la table + 
movem,l dS-d7/a3-a5,-(a7)  * pour garantir leur survie... * 
jer (ai) + exécute La routine ligne ‘A" L4 
moven.l (a7)+,d8-d7/a3-a5  * pour les ressusciter.., * 
retour 
rte # ATTENTION : rte ! * 


L'adresse de cette routine sera placée en $28.L, ce placement étant effec- 
tué en mode superviseur, après avoir initialisé la ligne A par A000, initiali- 
sation fournissant le pointeur A2 de la table système. Ce pointeur sera stocké 
dans la variable « adtable ». La variable « maxiligna » devra naturellement 
avoir été initialisée et « adtpers » devra pointer sur votre table d’adresses 
de routines. 


Il est ainsi possible d’implémenter jusqu’à 4080 nouvelles instructions 
de la ligne « À » (allant de A010 à AFFF), toutes appellables sur deux octets. 
1] ne faudra toutefois pas oublier que le niveau de priorité de la ligne « À » 
est supérieur à celui des interruptions auto-vectoriées, par exemple l’inter- 
ruption de balayage vertical. 


Jusqu’en novembre 1985, les systèmes d’exploitation diffusés pour le 
520 ST ignoraient la ligne « F »... Mais la nécessité de réduire le volume du 
système s’est faite plus grande, l'implantation en ROM ne pouvant être éter- 
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2 ent reportée ! Et le « truc » bien connu des développeurs sur 68000, 
Te==z'oi des instructions réservées, en l’occurrence la ligne F puisque le ligne 
< &zt déjà partiellement implementée, est devenu inéluctable. 


Fa janvier 1986, la ligne « F » demeure exclusivement utilisée dans 
T%ES, lequel couvre tout de même la moitié du système, mais qui peut pré- 
= jusqu'où elle débordera lorsque la ROM sera enfin implantée ! Aussi 
-=formations en ce domaine doivent-elles être prises avec prudence, leur 
IE de vie pouvant même être inférieure au délai de parution de l’ouvrage 
ze vous lisez ! 


Pourtant, il est certain que la ligne « F » demeurera implantée sur le 
DST, même si cette implantation constitue un pis aller puisqu'elle va à 
Z=onatre d’une portabilité ultérieure sur la ligne 68000. Rappelons en effet 
ZT le ligne « F » ne constitue pas une ligne « réservée » sur le 68020 et le 
E&ST-0 mais bel et bien un index d’instructions co-processeur pour virgule flot- 
=... Aussi l’information ne sauraïit-elle demeurer du domaine confiden- 
<, d'autant qu’elle autorise au programmeur un accès rapide et sûr vers 
Zäques 626 routines, à l’heure actuelle. 


Ces routines couvrent les domaines les plus variés, du traitement de chaîne 

o à Taffichage d’icônes en passant par la manipulation de fichiers, le traçage 

Se fenêtres, la gestion de timer et le déroulement de menus. Mais, plutôt que 

<s vous mettre simplement l’eau à la bouche, et compte tenu des possibles 

Solutions de la ligne « F », il semble préférable d’exposer ici la méthode 
exploitation et d'utilisation de cette ligne : 


2} Hre le contenu de Padresse $2C.L. Cette adresse correspond au vecteur 

æobal de traitement de la ligne « F ». 

73 désassembler la routine débutant à cette adresse. Cette routine sera en 

zracipe structurée ainsi : 

— dépilement du registre d’état (c’est-à-dire d’un mot), 

— test du contenu de l’adresse empilée suivante (qui n’est autre que le comp- 
teur de programme) et spécialement de son bit 0. 

— erpilement du registre d’état, ET logique avec les trois quartets bas du 
code d’instruction pointé, si bit 0 à 0. Puis, saisie de l’adresse de départ 
de la table des adresses de routines, ajout du code de l'instruction F (sans 
le quartet F) et saut absolu à la routine correspondante. 

— si le bit 0 du code d’instruction est impair, ET logique entre ce code et 
SFFF, afin de déterminer les registres à dépiler et fin. 

3) A partir de l’adresse de table obtenue par la routine précédente, on dis- 

gosera des adresses de toutes les routines de la ligne « F » et un désassem- 

blage ou/et des tests permettront de déterminer la fonction, donc l’utilisa- 

“on de ces routines. 
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Pour les instructions de la ligne « F » de code impair, la routine se livre 
à une manipulation des codes du programme lui-même qui donne à penser 
que cette routine devra être modifiée si elle est placée en ROM ou sera plus 
probablement implantée en RAM. 


A titre d’information, mais sans aucune garantie de fonctionnement sur 
votre système d'exploitation et bien sûr sans garantie non plus de portabilité 
sur les systèmes ultérieurs, voici quelques fonctions d’instructions de la ligne 
«F»: 


F034 Traçage de rectangle à partir d’une GRECT (voir F050). 

F044 Traçage d’une ligne brisée pointillée. 

F050 Conversion d’une GRECT (structure C, voir chapitre 2) en ensemble 
de cinq points pour traçage de rectangle. 

F080 Renvoie le minimum de deux nombres. 

F128 Renvoie le maximum de deux nombres. 

F1CCConcaténation de chaînes. 

F1E0 Comparaison de deux chaînes (retourne 1 si égales, O sinon). 

F250 Calcul de la longueur d’une chaîne. 

F268 Compare deux chaînes (retourne 0 si égales, différence sinon). 

F26C Recherche d’un caractère dans une chaîne, 

F3E4 Conversion d’un caractère en majuscule. 

F5D8 Enregistrement d'événements (primitive d’appl_record). 

F754 Traçage d’un rectangle en pointillé et avec ombre d’une GRECT. 

F758 Traçage d’un rectangle en pointillé à partir d’une GRECT. 

F77C Réinitialisation des paramètres de base du VDI. 

F898 Copie d’une chaîne. 

F9B0 Affichage du contenu d’un fichier à l’écran. 


La liste exhaustive de l’ensemble des fonctions de la ligne « F » débor- 
derait le cadre de ce libre (elle l’engloutirait même) et serait de peu d’intérêt 
dans la mesure où les implantations des routines sont sujettes à évolution 
tant que le système n’est pas en ROM. D'une façon générale, les routines 
de l’AES fonctionnant par transfert de paramètres empilés, les instructions 
de la ligne « F » devraient toutefois se révéler aussi souples d'emploi que 
les Traps. Il s’agit donc de la bibliothèque de fonctions la plus vaste et peut- 
être la plus utilisable de tout le logiciel système... 
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4. LIENS ENTRE LANGAGES 


£.1. Compilation et édition de liens 


Même aux développeurs professionnels les mécanismes de la compila- 
“on et de l’édition de liens restent parfois obscurs. Il est vrai que seule une 
analyse comparée détaillée des fichiers objets produits à chaque phase du 
zrocessus de compilation peut permettre d’appréhender ces mécanismes. Pour 
&re honnête, il faut également reconnaître que de notables différences exis- 
sen entre les divers compilateurs, l'analyse suivante étant essentiellement effec- 
mmée à partir du compilateur de Digital Research. 


Tout programme ne pouvant être compris d’un microprocesseur que s’il 
es écrit en langage binaire, les processus de compilation, d’assemblage et 
&’édition de liens sont destinés à effectuer la conversion d’un langage de pro- 
gammation en binaire. Pour un programme écrit, par exemple, en langage 
C, la compilation se déroule en plusieurs phases, chacune de ces étapes con- 
sisiant en la conversion d’un fichier dans un autre à l’aide des programmes 
suivants : 


— analyseur lexical (CP68). Sa première tâche est de supprimer tous les blancs 
et commentaires du programme source. Puis il établit une table des valeurs 
de variables indéfinies, charge chacun des fichiers à inclure (# include), 

compare les valeurs indéfinies aux « # define » de ces fichiers et opère 

es conversion nécessaires. De plus il stocke en tête du programme les 
énoncés de structures de ces fichiers « # include ». Enfin il remplace cha- 
cune des valeurs de variables définies dans le programme par un 

« # define » (ex : « # define flèche 0 » conduira au remplacement de tous 

les symboles « flèche » par la valeur 0). Le fichier produit a l'appendice « .I ». 
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— analyseur syntaxique (C068). Il effectue la phase principale de la compi- 
lation. Il construit une table des symboles contenant les noms de fonc- 
tions, les noms de variables et les étiquettes internes de branchement. Le 
fichier « .I » précédent est transformé en un fichier à suffixe « .1 », pré- 
codé. Ce pré-codage générique n’a pas de rapport avec les mnémoniques 
68000, il est semblable au pré-codage effectué pour une conversion en 
8086 par exemple. Le fichier produit n’est rien d’autre qu’un arbre syntaxi- 
que avec table des symboles et tables de précédence. 

— générateur de code (C168). A partir de l’arbre syntaxique (fichier « .1 »), 
ce programme génère un fichier en langage d’assemblage, c’est-à-dire en 
mnémoniques 68000. Les numéros de lignes sont ajoutés en commentai- 
res. Les registres de données DO à D7 sont codés R1 à R8 et les registres 
d’adresse sont codés R9 à R15. Les branchements locaux (internes aux 
procédures) sont codés à partir de LI. Le fichier produit a le suffixe « .S ». 


A tous les stades de la compilation, les fichiers générés sont en ASCII, 
Le fichier pré-codé produit par l’analyseur syntaxique n’en est pas pour autant 
très compréhensible, Sa lecture suppose une connaissance des procédures 
d’analyse « grammaticale » du langage, de traitement des tables d'analyse 
ascendante, concepts qui nous éloignent notablement du sujet principal de 
ce chapitre. 


Le fichier « .S », produit final de la compilation, est tout à fait sembla- 
ble à un programme écrit en langage assembleur même si le codage des registres 
et des labels locaux le rend un peu étrange, Les phases ultérieures d’assem- 
blage et d’édition de liens sont par conséquent identiques selon que l’on désire 
rendre exécutable un fichier « C » compilé ou un fichier écrit en langage 
d'assemblage. Ces phases sont : 


— L’assemblage (AS68). Conversion du fichier source ASCII en fichier 
binaire à suffixe « .0 ». Les appels de routines et les noms de variables 
externes à la procédure assemblée sont traduits par « $0 », qui indique 
une référence aux deux tables des noms de routines et des noms de varia- 
bles placées à la suite du fichier objet. La table des noms de routines est 
elle-même séparée en deux : table des labels externes et table des labels 
internes. Le fichier objet produit débute par une instruction de branche- 
ment suivie des caractéristiques du programme selon le schéma : 


mot long : nombre d’octets du texte (programme) 
mot long : nombre d’octets de la zone des données 
mot long : nombre d’octets réservés pour la pile 
mot long : nombre d’octets de la table des symboles 
puis 10 octets nuls (réservés). 
— L'édition de liens (LINK68). Un programme écrit en C ou en langage 
d'assemblage peut faire appel à des fonctions externes, par exemple des 
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cions GEM. L'édition de liens est destinée à rechercher dans des biblio- 
“ques les routines correspondant à ces appels et à associer au fichier 
obiet ces routines. De plus, à tout programme devant fonctionner dans 
l'environnement GEM doit être associé le fichier « GEMSTART » d’ini- 
æslisation des paramètres. Les bibliothèques essentielles sont : 


OSBIND : fonctions système (Traps, voir Annexe 4) 
VDIBIND : fonctions VDI (voir Annexe 2) 

AESBIND: fonctions AES (voir Annexe 2) 

GEMLIB : instructions C (comme printf, voir Annexe 1) 
LiBF : fonctions mathématiques. 


Le fichier produit par l'édition de liens comporte le suffixe « .68K » 
æ possède le même bloc de départ que le fichier « .0 » (voir ci-dessus). Il 
toutefois noter que l’édition de liens gonfle sérieusement le volume du 
æ objet, du fait de l’adjonction des routines externes et de la « table 
Eh Ji de liens » laquelle contient les détails sur les symboles globaux 
=T%sés. Les sauts à des routines sont codés « jmp $xy » (ou « jsr $xy »), 
= xy correspond à un déplacement relatif dans la table des symboles. 


— :s générateur de code exécutable (RELMOD). Le fichier « .68k » pro- 
&uit par l'édition de liens doit enfin être converti en fichier exécutable, 
äsuffixe « .PRG » par le programme RELMOD. En effet le fichier pro- 
dui par l'édition de liens contient 4 parties : 


Le code objet du programme 

Ea zone réservée aux données initialisées du programme, 

La table des symboles avec le déplacement relatif au début du programme 
æ le type (variable, label), 

Une table de précédence indiquant le type de chaque mof du programme, 
Tes adresses relogeables étant codées 0000. 


Le programme RELMOD laisse inchangés les trois premières parties mais 
avertit la dernière table en une table d’octets : en ajoutant le premier octet 
à L'adresse du début de programme on obtient la première adresse relogea- 
E's à convertir en adresse absolue, puis en ajoutant à cette adresse le deuxième 
axe, on obtient la seconde adresse à convertir, etc, La table ainsi obtenue 
2: de taille très réduite par rapport à la première et permet, lors du charge- 
sx du programme, une conversion très rapide des adresses relatives en adres- 
ss absolues. 


Ce survol rapide des diverses phases de la compilation et de l'édition 
Zs Jiens permet de relever que les trois dernières étapes sont indispensables 
<ême pour un programme en assembleur puisqu'elles conditionnent la réussite 
2 processus de lancement du programme. 
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Certains liens existent entre les bibliothèques qui méritent d’être signa- 
lés car il occasionnent de fréquentes erreurs : 


— la bibliothèque « GEMSTART » (ou son équivalent « ACCSTART » 
pour les accessoires) est indissociable de la bibliothèque « GEMLIB » 
(cette dernière implémentant la fonction « __main » pour les initiés). 

— la bibliothèque «GEMLIB » nécessite en principe d’être associée à 
« LIBF », certaines fonctions C utilisant les fonctions de conversion de 
type. Si toutefois votre programme ne comporte que des fonctions C non 
mathématiques, les manques signalés à l’édition de liens (ex. « undefi- 
ned : _etoa, _ftoa ») sont sans importance et ne gênent pas le fonction- 
nement du programme. 


Si l'édition de liens et la génération de code exécutable doivent obliga- 
toirement être pratiquées, rien n’oblige par contre à lier le programme à des 
bibliothèques, à partir du moment où aucun appel externe n’est effectué et 
si l’on désire simplement produire un programme TOS, donc n’utilisant pas 
l’environnement GEM. Un exemple en est d’ailleurs fourni au chapitre 3 avec 
le programme d'installation d’un disque virtuel. Notons également que le 
suffixe « TOS » peut remplacer le suffixe « PRG », selon le bon vouloir du 
programmeur ou de l’utilisateur. Ce suffixe n’est pas texté pour l’exécution, 
seule la structure du programme et l’appel ou non à des fonctions GEM font 
qu’un programme tournera sous GEM ou non. Même l’installation d’une 
application à partir du Bureau (option du Menu) n’a qu’un effet réduit sur 
Pexécution : on dispose de la souris et d’une barre portant le titre du pro- 
gramme en haut de l’écran si le programme est installé en GEM, on dispose 
d’un écran blanc si le programme est installé en TOS. 


Lors de l’appel d’un programme à partir du Bureau (ou à partir du 
« COMMAND.PRG » fourni avec le CP/M-68k), le programme est chargé 
en mémoire à partir de la plus basse adresse disponible. 256 octets sont réservés 
au début de cette zone pour les informations sur le programme, informa- 
tions provenant du bloc de départ du programme et adaptées à l’environne- 
ment. Ce bloc a la structure suivante : 


$0.L. adresse absolue de départ de ce bloc (!) 

$4.L adresse du haut de la mémoire vive disponible + 1 (non compris les 
32 Ko réservés à la mémoire d’écran) 

$8.L adresse absolue de départ du programme (codes) 

$C.L. longueur du programme (codes, en nombre d’octets) 

$10.L adresse absolue de départ des données initialisées 

$14.L longueur de la zone des données initialisées 

$18.L adresse absolue de départ des données non initialisées 

$IC.L longueur de la zone des données non initialisées 
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EE adresse de la ligne de commandes du programme 
ETF adresse de l’environnement (ex : « PATH = .A: 1») 
SES début de la ligne de commandes (si elle existe) 


À fa suite de ce bloc sont placées les trois zones du programme : codes, 
Z—£Ss initialisées et données non initialisées. Au chargement, toute la 
ère disponible est réservée et la pile du programme est donc placée juste 
Æ Ésssous de la mémoire d’écran. Une fois les adresses « relogeables » con- 
Es en adresses absolues et après exécution du début du programme (placé 
GEMSTART à l'édition de liens), seuls 1024 octets sont réservés à la 
—e du programme pour la pile, le reste de la mémoire devenant disponible 
fes allocations ou l’éventuel chargement d’autres programmes. 


Au-delà des mécanismes généraux de la compilation et de la mise en route 
Ze zrogrammes décrits ci-dessus, il semble utile d’aborder les principaux pro- 
5 es pratiques pouvant survenir : 


!. Les erreurs syntaxiques ou les oublis constituent l’immense majorité des 
æers relevées à la compilation. Les erreurs se produisant à l’édition de liens 
ment plutôt d’une méconnaissance du contenu des bibliothèques ou de 
ss interactions. Nous ne saurions trop conseiller de désassembler les fichiers 
Zss bibliothèques pour mieux connaître celles-ci. Une lecture attentive des 
ESters de définition leurs correspondant est encore plus nécessaire. et plus 
Eée. 

Z Le compilateur et l’éditeur de liens fonctionnent bien, du moins pour ce 
Zi est du système de Digital Research, et, d’une façon générale, mieux vaut 
Iputer les erreurs survenant à votre programme qu’au compilateur. même 
& Perreur signalée semble correspondre à une erreur système. Un exemple 
Zassique illustre bien cette règle : l’apparition du message d’erreur « it read 
&ror » ou « intermediate read error on », lors de l'assemblage. Cette erreur 
es uniquement due au fait que votre disque est plein ! 


Ceci nous conduit à fournir quelques statistiques de tailles de fichiers 
sfrectuées à partir dela compilation d’une trentaine de programmes de taille 
æès diverses et faisant pour la plupart appel au GEM : 


fichier source .C : 100 (mesure étalon) 
fichier compilé .I : 100 
fichier compilé .1 : 170 
fichier compilé .2 : 2 
fichier compilé .S : 150 
fichier assemblé .0 : 80 
fichier lié .68k  -: 310 
fichier objet .PRG : 180 
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Ces mesures sont naturellement tout à fait dépendantes de la taille des 
commentaires dans le programme source, du nombre d’appels à des fonc- 
tions GEM, de la longueur des programmes, etc. Ces chiffres donnent tou- 
tefois des indications sur l’espace mémoire ou sur disque nécessaire pour une 
compilation ou une édition de liens. Si l’on conserve le fichier source, la place 
la plus grande est requise à la compilation lors du passage par le générateur 
de code (C168). Alors doivent cohabiter les fichiers..C, .1, .2 et .S soit un 
volume souvent supérieur à 4 fois le volume du fichier initial. A l’édition 
de liens, la coexistence du fichier source .C, du fichier assemblé .O, du fichier 
lié .68k et des fichiers temporaires nécessite un volume souvent supérieur à 
6 fois le volume du fichier source. Ainsi l'obtention d’un fichier objet de 
70Ko a-t-elle demandée à l’auteur une réservation de 600 Ko de mémoire 
(en disque virtuel). Au-delà, il faut compiler et lier avec effacement du fichier 
source, stockage de fichiers de travail sur un autre lecteur de disque... ou 
disposer d’un disque dur ! 


3. Une ligne de commande en CP/M-68k peut simplement contenir 126 carac- 
tères. Au-delà, soit une recherche de fichier est effectuée sur la base de ces 
126 caractères, soit, dans la version la plus récente (LTG), il y a purement 
et simplement « plantage » du 520. Il ne s’agirait là que d’une anecdote si 
l’édition de liens ne demandait pas parfois des commandes plus longues ! 
À ce mal, un seul remède : raccourcir le nom des fichiers liés au minimum 
possible (une lettre), ce qui permet de lier un peu plus d’une vingtaine de 
fichiers. Dans l’état actuel, il ne semble pas possible de faire mieux ! Rele- 
vons que cette restriction est également valable si l’on utilise un « batch », 
lequel n’est qu’une simple suite de commandes envoyées précisément vers 
le «COMMAND.PRG », noyau du CP/M-68k. En fait LINK68 reconnaît 
les fichiers à appendice ’INP”. On peut donc linker autant de fichiers que 
nécessaire en les plaçant dans un fichier d’appendice INP”. 


4.2. Accès aux fonctions GEM en Basic 


Au jour où sont rédigées ces lignes le Basic fourni avec le 520 ST ne 
dispose d'aucune documentation, sinon une liste des instructions, d’ailleurs 
entachée de fautes d’orthographes et de manques. De plus l'absence quasi 
totale de traitement d’erreurs rend cet interpréteur pour le moins délicat 
d'emploi. Essayer d’entrer l'instruction « sound 1000000 » ou, pire, « dir 
0: »… 


Pourtant ce Basic est bien conçu et offre des possibilités étonnantes, en 
particulier pour accéder aux fonctions GEM (VDI et AES). Faute de docu- 
mentation, il a fallu rechercher les informations fournies dans ce chapitre 
(et au chapitre 5 pour SOUND et WAVE) dans le désassemblage de l’inter- 
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eur... Ces informations ont ainsi le mérite de pouvoir être garanties authen- 
zuss et fonctionnelles ! Il ne faut cependant pas écarter l'éventualité de modi- 
Éxtions ultérieures dans l’énoncé ou le mode d’emploi de certaines instruc- 
Tens Basic. On relèvera, par exemple, que la seule et unique variable per- 
==sant l'accès aux fonctions ABS s’appelle GB (pour GEM Block sans doute), 
20m d’instruction n’apparaissant nulle part dans la liste « officielle » des 
E=sructions. 


Ces préalables étant posés, il nous a paru nécessaire de fournir quel- 
ss indications et exemples sur l'emploi du GEM à partir du Basic, une rai- 
sra suffisante étant qu’il est ainsi possible au programmeur dans ce langage 
Tatiliser toutes les informations fournies en Annexe 2. Le programmeur en 
€ ou en assembleur pourra aussi tester telle ou telle fonction à partir du Basic, 
æsernative souvent intéressante compte tenu des temps de compilation et de 
“blocage. 


En Basic, deux instructions permettent d’appeler le GEM : 


VDISYS permet d’appeler une fonction VDI. 
GEMSYS permet d'appeler une fonction AES. 


On notera la confusion de termes pouvant être provoquée par 
« GEMSYS », qui ne constitue pas un appel générique mais bel et bien de 
PAES... Dans les chapitres précédents les méthodes d’appel des fonctions 
GEM ont été plusieurs fois illustrées (voir aussi l’ Annexe 2). Rappelons cepen- 
dant qu'une fonction GEM nécessite généralement des paramètres d'appel 
& de retour, Ces paramètres sont stockés dans des tableaux d’entiers (contrl, 
tntin, ptsin, intout, ptsout pour le VDI ; control, global, int_in, int_.out, 
æddr_in et addr_out pour l’AES). Pour appeler une fonction GEM à partir 
du Basic, il sera naturellement nécessaire d’initialiser les paramètres de cette 
fonction. 


Appel de fonction VDI 
Pour une fonction VDI, les variables Basic suivantes sont utilisées : 


CONTRL (10 mots) sert à placer les paramètres fonctionnels. 
INTIN (80 mots) pour stock des paramètres d’appel entiers. 
PTSIN (128 mots) pour coordonnées en appel (2 entiers). 
INTOUT (45 mots) pour stock des paramètres de retour entiers. 
PTSOUT (12 mots) pour coordonées en sortie (2 entiers). 


Les variables CONTRL, INTIN, PTSIN, INTOUT, PTSOUT sont des 
2ointeurs, autrement dit leur contenu est égal à l’adresse de départ de la zone 
concernée. Si vous entrez « PRINT CONTRL », il s’affichera dans la fenêé- 
tre de sortie un nombre, par exemple 453150. Cela signifie que le tableau 
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CONTRL commence à cette adresse. Ainsi « PRINT PEEK (453150) » vous 
fournira la valeur entière de CONTRL{0]. Pour placer une valeur x dans 
CONTRL{5|, par exemple, vous entrerez : « POKE x, CONTRL +10 ». En 
effet, 5 entiers font 10 octets, l’adresse doit donc être augmentée de 10. 


Les zones PTSIN et PTSOUT servent à écrire ou lire des paramètres 
points, c’est-à-dire des ensembles de deux entiers définissant les coordon- 
nées de ces points. L’annexe 2 fournit pour l’ensemble des fonctions VDI 
le nombre et le rôle des différents paramètres d’appel. La zone CONTRL 
est définie comme suit : 


CONTRL|0] 
CONTRL.{1] 


numéro de la fonction VDI. 

nombre de vecteurs dans PTSIN (un vecteur est un long 
mot puisqu'il est formé de deux entiers) 
CONTRL/?] = nombre de vecteurs dans PTSOUT (cf. ci-dessus). 
CONTRL/3] = nombre de paramètres entiers dans INTIN. 
CONTRL{4] = nombre de paramètres entiers dans INTOUT. 


Ces variables doivent être initialisées avant l’appel d’une fonction VDI. 

CONTRL{6] ne doit pas être positionné car il est initialisé une fois pour 
toutes par l’interpréteur, en principe à la valeur 2. Par contre CONTRL(5| 
et CONTRL/{7] à CONTRL{11] doivent parfois être initialisés (voir chapitre 
fonction en Annexe 2 pour ces cas particuliers). 


WI 


Exemples d'appel d'une fonction VDI en Basic : 


10 POKE CONTRL,11:" numéro de fonction VDI 

20 POKE CONTRAL+2,2:" 2 vecteurs {(PTSIN) en entrée 

30 POKE CONTRL + 4,0:" O vecteur (PTSOUT} en sortie) 

40 POKE CONTRL+ 6,0:' 0 entier (INTIN} en entrée 

50 POKE CONTRL+8,0:" 0 entier (INTOUT}) en sortie 

60 POKE CONTRL + 10,8: numéro de la sous-fonction 

70 POKE PTSIN,400:’ abcisse du premier sommet 

80 POKE PTSIN + 2,46:° ordonnée du premier sommet 

90 POKE PTSIN + 4,600:' abcisse du sommet opposé 
100 POKE PTSIN +6,150:" ordonnée du sommet opposé 
110 VDISYS:" appel de la fonction 


Ce programme est équivalent à l’appel en C : 


vrbox(id_vdi, xysurface) 
où xysurface désigne un rectangle défini par ses deux sommets opposés. La 
sous-fonction 8 provoque le dessin d’un rectangle aux coins arrondis. On 
relèvera que l’identificateur (CONTRLI6|) n’est pas placé en Basic. 


Cet exemple étant un peu particulier (l’appel de sous-fonction est rare), 
voici un autre exemple plus spectaculaire : 
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10 POKE CONTRL, 106: numéro de la fonction VDI 
20 POKE CONTRL +2,0:’ aucun vecteur en entrée 

30 POKE CONTRE +4,0:’ aucun vecteur en sortie 

40 POKE CONTRL +6,1:° un paramètre entier en entrée 
50 POKE CONTRL +8,1:’ un paramètre entier en sortie 
60 POKE INTIN,9: paramètre d’entrée 
70 VDISYS:’ appel de la fonction 


Ce programme correspond à l’appel de la fonction vst_effects, avec pour 
garamètre d’entrée 9, correspondant à un texte en gras et en italique. Après 
exécution, vos entrées clavier et les affichages se feront en caractères gras 
& italiques.… jusqu’à un appel de l’éditeur qui rétablit le style de caractère pa 
par défaut, c’est-à-dire normal, | 


Toutes les fonctions du VDI peuvent être appelées de cette façon. Cer- 
tains appels sont de peu d'intérêt, une instruction correspondante ayant le 
même effet en Basic (par exemple CIRCLE ou LINEF), d’autres peuvent 
permettre des effets graphiques tout à fait étonnants. Il est ainsi possible | 
d'effacer tout l’écran par v_clrwk (fonction 3 du VDI), avec passage en mode 
alphanumérique ! Il faut toutefois savoir que certaines instructions n’ont vrai- 
ment d'utilité que dans un programme, l’interpréteur Basic replaçant ses pro- } 
pres paramètres lorsqu’il reprend le contrôle de l’écran. 


D'une façon générale, les appels aux fonctions GEM présentent un taux ; 
de dangerosité certain, toute erreur dans un paramètre se traduisant souvent ijl 
par le « plantage » de la machine. Il est donc conseillé de sauver son pro- Là 
gramme avant de le tester ! Une bonne mesure de prudence consiste aussi 
à éviter de manipuler CONTRL{6|. 


Rappelons par ailleurs qu’en Basic ST, le POKE s’effectue normalement | | 
sur un ENTIER. Il peut être éventuellement pratiqué sur un long mot si s 
l'adresse pokée est suivie de l’appendice « # » (double longueur). Ainsi : 


POKE 450146,12 met O0 dans la mémoire d’adresse 450146 et met 
12 dans la mémoire d’adresse 450147. 

POKE 450146 #,12 met 0 dans les mémoires d'adresse 450146 à 450148 
et 12 dans la mémoire 450149, 


Appel de fonction AES 


L’appel des fonctions AËS à partir du Basic est un peu plus délicat que 
l'appel de fonctions VDI. Aux six zones de paramètres de l’AES ne corres- 
pond en effet qu’une seule variable Basic qui, par double accès indirect, auto- 
rise toutefois un paramétrage complet. Cette variable GB pointe sur un tableau 
de pointeurs correspondant aux 6 zones de paramètres, Ainsi : 
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ES 


Es 


peek(cdbl (GB)) = adresse de CONTROL. 


adresse de GLOBAL. 
adresse de INT_IN. 
adresse de INT_OUT. 
peek(cdbl (GB+16)) = adresse de ADRR IN. 
peek(cdbl (GB+20)) = adresse de ADRR OUT. 


Il est nécessaire d’utiliser « cdbl » pour obtenir le contenu long de la 
mémoire adressée (le suffixe # étant réservé aux nombres). Les zones 
CONTROL, GLOBAL, INT_IN, INT_ OUT, ADRR_IN, ADDR_OUT sont 
détaillées en Annexe 2. Pour l’appel d’une fonction ABS, contrairement à 
l'appel d'une fonction VDI, il est inutile de s’occuper de la zone CONTROL, 
laquelle est prise en charge par l’interpréteur. Il n’est pas non plus néces- 
saire de s’occuper de la zone GLOBAL, laquelle n’est pas prise en compte 
du tout ! 

L'emploi de certaines fonctions de l’AES est interdit, il s’agit des fonc- 
tions appl_init et appl_exit, leur appel risquant d’interférer gravement avec 
le fonctionnement de l’interpréteur. Toutes les autres fonctions peuvent être 
utilisées, mais certaines sont très délicates d’emploi et requièrent un soin 
extrême dans le paramétrage. Il s’agit en particulier des fonctions nécessi- 
tant des adresses en paramètres d’appel. Si l’adresse fournie est incorrecte, 
adieu programme, adieu Basic jusqu’au Reset. 

Ces risques étant connus, des perspectives grandioses s’ouvrent au pro- 
grammeur en Basic, qui peut ouvrir des fenêtres de dialogue, ajouter ou sup- 
primer des objets à celles-ci, afficher des fenêtres d’alerte ou d’erreur, chan- 
ger les items du menu, utiliser les événements souris ou timer, etc. Voici quel- 
ques exemples d’application possibles : 


peek(cdbl (GB +4)) 
peek(cdbl (GB +8)) 
peek(cdbl (GB +12)) 


UN 


Exemples d’appels d’une fonction AES en Basic 


Court mais bon : 10 GEMSYS 53 


Ce programme(!) affiche une fenêtre d’erreux avec un numéro aléatoire, 
en principe 0 mais en fait le contenu de INT_IN[0] lors de l’appel. 
Pour faire afficher un numéro d’erreur donné, il faut un programme plus 


long : 

10 entent = peek(cdb1(GR+8)):? +ournit l'adresse de INTIN 

20 poke entent,12:? pourquoi pas l’erreur 127 

50 gemsys US:° affichage de fenêtre d’erreur 


On notera que la fenêtre est réellement une fenêtre d’erreur, pas un fan- 
tôme, ainsi il est nécessaire de cliquer le bouton « OK » pour en sortir ! Cette 
réalité peut être testée par un programme un peu plus élaboré d’affichage 
de fenêtre d’alerte (cf. les fonctions AES en Annexe 2, respectivement 
form_error et form_alert) : 
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LT aient = peek(cdbl (6B+8))27 fournit l'adresse de INT_IN 
Z arent = peskicdbl(GB+14))27 fournit l'adresse de ADDR_IN 
ZÆ as="{1){Voici une fenetre d’alertel[OK!Ah bon! lAnnuler fi 
Æ éfchaine = varptr (a$):" fournit l'adresse de la var. a$ 


entent, 11° paramètre d'entrée = 1 
= cdbl (adrent),adchainer” adresse en entrée = adchaîne 
geasys 52:° affichage de la fenêtre 
tsort=peuk {cdbl (6B+12)):? paramètre de sortie 


T2 grint°Vous avez pressé le ";peek(entsort)};"e bouton" 


A l’exécution, ce programme provoque l'affichage d’une fenêtre d’alerte 
æret le texte « Voici une fenêtre d’alerte » et trois boutons : « OK », « Ah 
Bo ! », « Annuler ». Le paramètre d’entrée placé en ligne 50 correspond 
à la mise par défaut du bouton 1 (« OK »). Les variables entent, adrent et 
Sssort correspondent respectivement à INT_IN, ADRR IN et INT OUT. 
Rappelons enfin que l’instruction Basic VARPTR permet d’obtenir l’adresse 
une variable. Cette instruction est particulièrement utile, conjuguée à l’appel 
<e fonction AES, 


Le programme suivant fournit une bonne illustration de l’intérêt d’appeler 
&ss fonctions AES en Basic. Il utilise la fonction « evnt_ keybd », qui est 
za peu semblable à un inkey$ et affiche le code clavier et le code ASCII de 
le touche pressée. La sortie du programme s’effectue par un appui de la tou- 
che Return : 


19 entsort = pesk(cdbl (GB+12) ):° adresse de INT_OUT 


2 shile (boutsart<>13):° boucle en attente de Return 
TO gensys 20: appel de evnt_keybd 

+0 boutsort=peek (entsort) :? codes de la touche appuyée 
% codcia=int (boutsort/256) :” masque le code clavier 

Æ toutsort=boutsort and 255:7 masque le code ASCII 

70 print"code:";codcla; "ASCII: "sboutsort: affichage 

0 wend:? ferme la boucle while/wend 


Ces exemples ne sont là que pour vous aider à entreprendre des pro- 
grammes faisant appel aux fonctions GEM et pour vous mettre l’eau à la 
bouche ! Une programmation sérieuse de ces fonctions devrait débuter par 
l'initialisation des variables AES (INT IN, INT OUT, ADDR IN, 
ADDR_ OUT) et peut-être même par l’initialisation des principaux paramè- 
tres (ex : ent2ent = peek(cdbl(GB + 8)) qui pointera INTIN/2}, etc. 


Pour conclure ce sujet, rappelons que les informations ci-dessus pour- 
raient être rendues caduques par une nouvelle version du Basic ou pourraient, 
plus vraisemblablement, vous sembler bien banales, un manuel sérieux étant 
disponible entre temps ! 


4.3. Multitâche et Accessoires 


4.3.1. Quel multitâche ? 


Le système d’exploitation du 520 ST n’est pas à proprement parler mul- 
titâche. On définit en effet comme multitâche un système d’exploitation capa- 
ble d’assurer le déroulement de plusieurs programmes dans une apparente 
simultanéité (en fait, les programmes sont exécutés successivement durant 
de très courts intervalles de temps). Pourtant le GEM dispose de capacités 
multi-environnement qui valent d’être analysées. 


Lors du lancement du système, après un certain nombre d’opérations 
d’initialisations, est exécuté le programme maître de l’AES. Ce programme 
débute par une ouverture de poste de travail (v_opnwk), raison pour laquelle, 
d’ailleurs, il n’est possible ensuite d’ouvrir que des stations virtuelles 
(v_opnvwk), puis le Bureau (SCRENMGR) et les accessoires éventuels 
(DESK1, DESK?2, DESK3) sont initialisés. Dès lors, l’ensemble de l’activité 
du 520 est sous le contrôle de l’AES et spécialement d’un programme d’ordon- 
nancement, s’apparentant au « scheduler » bien connu du multitâche. 


Le Bureau, les accessoires et l'application éventuellement lancée, dis- 
posent tous d’un identificateur (gl_apid de appl_init) et, si un seul programme 
est actif à un moment donné, l’ordonnanceur, sur la base des identificateurs, 
effectue en permanence un partage des ressources entre les différentes appli- 
cations. C’est ce partage qui vous autorise, par exemple, à ouvrir un acces- 
soire dans le cours d’un programme. 


La plupart des événements sont toutefois gérés sur le mode des inter- 
ruptions. Ainsi, lorsque vous déplacez la souris, ce déplacement, s’il est suf- 
fisamment significatif (cf. 5.2. commande $B), provoque une interruption 
clavier. Le traitement de celle-ci se résume à un enregistrement de la nou- 
velle position de la souris. A l’interruption de balayage vidéo suivante, l’acti- 
vité de la souris est testée et, si elle est active et s’il y a eu changement de 
position depuis la dernière interruption de balayage, le pointeur de souris 
est modifié à l’écran. 

Dans ce cas simple et particulier, seule l’activité ou non de la souris dans 
l'application active est testée. La procédure est plus complexe si l’événement 
à traiter par l’ordonnanceur est un « message », par exemple un cliquage 
dans la case de fermeture d’une fenêtre. Dans un tel cas, l’activité de la fenêtre 
est testée. Si la fenêtre est active, il y a fermeture avec éventuellement fin 
de l’application si celle-ci ne possédait qu’une fenêtre. Sinon, le cliquage dans 
la case de fermeture est assimilé à une demande de réactivation, d’où pas- 
sage d’une application à une autre si la fenêtre cliquée n’appartient pas à 
lPapplication active (cas d’un accessoire, par exemple). 
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Les interactions entre le Bureau et l’utilisateur (le Bureau étant consti- 
TS de l’ensemble des éléments extérieurs à la fenêtre active, autrement dit 
Z barre des menus, les cases de fermeture, de réajustement de taille, etc.) 
seat contrôlées par le programme principal de l’AES (SCRENMGR, gestion- 
care d’écran). 


Les instructions GEM appl_read, appl_write, appl find et l’ensemble 
<ss fonctions « Shell » (cf. Annexe 2) autorisent une certaine forme de com- 
=mmication entre diverses applications, des informations pouvant être envoyées 
ge l’une à l’autre, Il s’agit d’une implémentation très primitive du canal 
«: PIPE » des systèmes multitâches, ouvrant tout de même quelques pers- 
gectives intéressantes, l’envoi de messages (codes de touches clavier, opéra- 
“ons de manipulations de fenêtres) étant ainsi possible. 


Selon une expression désormais courante, le « couper/coller » est éga- 
Tement possible entre plusieurs applications. Il s’opère par le biais du « clip- 
board » (que nous ne traduirons pas par « presse-papiers » !) et de fichiers 
& SCRAP ». Les instructions AES permettant d'utiliser ce « clipboard » sont 
grésentées au chapitre 2 (scrp_read et scrp_write). On notera que le passage 
d'informations d’une application à une autre par ce moyen oblige à des accès 
disquettes, ce qui garantit du moins la pérennité de ces informations mais 
S’avère un procédé assez lourd, en particulier lorsque l’on désire « couper/col- 
Îer » avec un accessoire. 


4.3.2. Accessoires 


Les accessoires constituent des applications comme les autres, comme 
le gestionnaire d’écran ou le traitement de texte. Leur particularité tient à 
ce que leur contrôle peut être effectué à partir de la barre des menus (option 
« Bureau »). 


Seuls trois programmes accessoires peuvent fonctionner concurremment 
à une application, cette limitation étant due à des impératifs de limitation 
des zones de mémoire système (chaque application possède son en-tête, ses 
tampons, ses drapeaux). Ces trois programmes peuvent se partager jusqu’à 
six accessoires, le partage pouvant être effectué de façon quelconque (il est 
même envisageable de donner le contrôle des six accessoires à un seul pro- 
gramme). La limitation à six accessoires est due à un choix préétabli de la 
barre des menus, dont l’option « Bureau », contrôlée par le gestionnaire 
d'écran, ne peut comporter que six items dédiés aux accessoires. 


On peut regretter que les concepteurs du GEM n’aient pas prévu la pré- 
sence simultanée de plus de 6 accessoires. Rappelons toutefois qu’il est tou- 
jours possible, par des manipulations assez complexes des objets du Menu, 
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de modifier le titre d’un accessoire, ce qui permet, si le programme acces- 
soire est prévu pour cela, de gérer plusieurs sous-programmes pour un même 
numéro d’accessoire. 


Comment se fait-il qu’un même programme puisse contrôler plusieurs 
accessoires indépendants, donc plusieurs applications ? A cette question, le 
désassemblage du système, spécifiquement de l’AES, permet de répondre 
ainsi : 

— Un accessoire n’est pas une application. Seul le programme accessoire 
constitue une application, c’est-à-dire une entité pourvue d’un identifi- 
cateur d’application et de caractéristiques graphiques indépendantes. 

— L’initialisation de chacun des items accessoires du Menu est effectuée par 
le programme accessoire (cf. menu_ register). ° 

— Le programme accessoire, une fois l’initialisation opérée, reste toujours 
actif, Il boucle dans une attente de message (evnt_mesag). 


Cette boucle d’attente est toutefois une fausse boucle, comme toutes les 
fonctions GEM d’attente d’événement., En fait, lorsque l’on utilise une fonc- 
tion « evnt » de l’AES, on redonne la main à l’ordonnanceur en lui signa- 
lant que l’on attend tel ou tel type d'événement. L’ordonnanceur examine 
alors si d’autres applications ou accessoires sont suspendus et s’ils doivent 
donc être réactivés et, dans le cas contraire, attend l’événement suivant et 
selon la nature de ce dernier réactive telle ou telle application en attente. 


Pour en revenir au cas particulier de l’accessoire, l'attente au départ est 
celle d’un message. Si un message arrive, son numéro est comparé à 
« AC.OPEN » et, si c’est le message reçu, le quatrième mot du message est 
comparé à l’item du Menu correspondant à chaque accessoire du programme. 
S’il y a correspondance des numéros, alors l’accessoire concerné est activé. 
Cet accessoire peut alors ouvrir une station de travail virtuelle, une fenêtre, 
etc., comme toute application. Naturellement, lors de la sortie de l’acces- 
soire, la station de travail et la (ou les) fenêtre(s) doivent être refermées. 


Si l’on désire créer un ou plusieurs accessoires, la différence entre acces- 
soire et programme accessoire doit être parfaitement comprise, faute de quoi 
l’on s’expose à de nombreux déboires. Aïnsi le passage d'informations à partir 
d’une application ne peut se pratiquer que vers un programme accessoire, 
quitte à ce que ce programme redirige ensuite ces informations vers tel ou 
tel accessoire. Il faut reconnaître que la meilleure façon de créer des acces- 
soires consiste à faire coïncider un accessoire et un programme accessoire. 


En matière d’accessoire, tout ou à peu près est réalisable, une fois con- 
nues les règles de maniement décrites ci-dessus. Ainsi, bien que le démar- 
rage normal d’un accessoire s’effectue lorsque survient un message d’acti- 
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vation (AC OPEN), rien ne s'oppose à ce que soit un evnt_timer ou un 
evnt_multi qui contrôle l’accès à tel ou tel accessoire. A titre indicatif, 
louverture de laccessoire « panneau de contrôle » s’effectue par un mes- 
sage « AC OPEN » avec identification du numéro d’item correspondant à 
« panneau de contrôle » dans la barre des menus, mais la « boucle » du pro- 
gramme accessoire est en fait un evnt_multi, à la fois message et timer. C’est 
Févénement timer qui provoque la remise à l’heure de l’horloge toutes les 

. minutes, permettant ainsi de disposer de l’heure sur le Bureau, à partir du 
moment où le panneau de contrôle a été ouvert et même si cet accessoire 
m'est plus activé. 


Par un procédé identique à celui utilisé pour le panneau de contrôle, 
il serait possible, par exemple, de déclancher l’ouverture d’un accessoire ou 
d’une simple fenêtre à une heure donnée (fonction alarme). Sans entrer dans 
les détails, la question étant abordée au chapitre 2 et en annexe 2, signalons 
pour conclure que les interactions entre les affichages et, d’une façon géné- 
rale, les opérations graphiques, d’une application et des divers accessoires 
sont à l’origine de nombreux problèmes internes de fonctionnement des pro- 
grammes. Tout test de programme devrait, en conséquence, comprendre plu- 
sieurs tests relatifs aux accessoires : ouverture simultanée à l’application.de 
plusieurs accessoires, déplacement de la fenêtre du panneau de contrôle ou 
de l’application, avec ouverture et fermeture et surtout avec simple désacti- 
vation de chacun des accessoires. 
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5. PROGRAMMATION 
DES ENTRÉES-SORTIES 


L’immense majorité des fonctions GEM et des fonctions système, les- 
elles sont détaillées en annexes, sont consacrées aux entrées-sorties, affi- 
age graphique pour le GEM et opérations élémentaires ou traitement de 
Æchiers pour les fonctions système (traps). La compréhension et l’utilisation 
£e ces fonctions devrait normalement suffire à tout programmeur pour résou- 
£re un quelconque problème d’entrée-sortie. 


Dans la pratique certaines fonctions ressemblent à la mère Gigogne.… 
Ainsi de la commande de sortie du synthétiseur de son et surtout de la fonc- 
“on d’envoi de commandes au microprocesseur clavier, cette dernière auto- 
zisant par exemple la lecture ou l'écriture de mémoires du 6301 et même la 
£smande d’exécution de routines internes à ce processeur. Enfin la ques- 
“on des interruptions nous paraît mériter quelques développements. 


5.1. Les interruptions 


Le 68000 supporte 7 niveaux d'interruption, par le biais de trois lignes. 
Ces interruptions sont masquables en plaçant les bits 8 à 10 du registre d'état 
3 un. Sur le 520 ST, seuls deux niveaux d'interruption sont vectorisés : les 
miveaux 2 et 4, correspondant aux interruptions horizontale et verticale de 
balayage vidéo. 


L’interruption de niveau 2 (fréquence de ligne) est masquée par le système 
à l'initialisation. Étant donné qu'un programmeur ignorant pourrait la démas- 
quer, par exemple en replaçant à 0 les bits 8 à 10 du registre d'état, une rou- 
fine de traitement existe. Cette routine ne fait qu'une chose : elle replace le 
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masque dans le registre d’état et inhibe donc de nouveau l'interruption de 
niveau 2 ! 


L’interruption de niveau 4 (fréquence de trame) est par contre fort uti- 
lisée par le TOS. Elle n’est masquée que fort rarement, lors de modifica- 
tions liées à l’écran (envoi de commandes au contrôleur vidéo) ou lors de 
« portions critiques » du code (changement de mode du 68000, initialisation 
d'un vecteur d'interruption 68901, etc.). Cette interruption est provoquée 
par le contrôleur vidéo à chaque balayage vertical, c’est-à-dire 70 fois par 
seconde avec un moniteur monochrome et 60 fois par seconde avec un moni- 
teur couleur. 


La routine vectorisée d’interruption de niveau 4 exécute l’ensemble des 
tâches suivantes : 


— incrémentation du compteur d’interruptions verticales ($466.L). 

— test du drapeau de prise en compte des interruptions verticales ($452) et 
incrémentation du compteur $466.L si le drapeau est à 1. Ce drapeau doit 
être placé à 0 lorsque l’on change la base de la mémoire d’écran. 

— test de moniteur (à travers le bit 7 de $FFFAO1) et modification éven- 
tuelle de la résolution vidéo avec départ chaud. 

— test de l’état du curseur (actif ou non) et affichage ou effacement selon 
le nombre de périodes écoulées depuis le dernier changement. 

— test du pointeur de palette ($45A) et implantation éventuelle d’une nou- 
velle palette de couleurs. 

— test du pointeur de base écran ($45E) et changement de base si ce poin- 
teur est non nul.. 

— desélection des lecteurs de disques si non verrouillés (toutes Les huit inter- 
ruptions verticales), 

— exécution de chacune des routines d’une liste dont l’adresse de départ 
est contenu dans $456. 

— test du drapeau de copie d’écran ($4BE) et « spooling » d’imprimante 
si le drapeau est à 0. 


La partie la plus intéressante et la plus accessible au programmeur de 
cette routine d’interruption est sans conteste l’exécution des routines poin- 
tées par $456. A cette adresse est placé un pointeur vers une liste de poin- 
teurs. Cette liste de pointeurs débute normalement en $4CE (valeur conte- 
nue dans $456). A l’ouverture d’une station de travail (v_opnwk), une adresse 
de routine est placée dans cette liste (traitement du retraçage de la souris). 


Pour faire exécuter une routine à chaque interruption verticale, il suffit 
de demander le contenu de $456 puis, à partir de l’adresse de base contenue 
dans $456, de tester chacun des longs mots et de placer l’adresse de sa rou- 
tine à la place du premier long mot nul. La liste peut contenir au maximum 
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1- 


1- 


Taesses de routines (elle est en fait de 8 éléments mais le dernier doit être 


SE 


Zrsruptions 68901 
3e circuit multi-fonctions de gestion des périphériques 68901 gère la plu- 
ide périphériques et par ce fait les interruptions que ceux-ci provoquent. 
Ts féerruptions sont répercutées vers le 68000 par le biais de seize vecteurs 
T&$F) provoquant l'exécution des routines vectoriées $100 à $13C. Cha- 
2 ée ces vecteurs à la priorité (pour le 68901) et la fonction suivante : 


eur priorité fonction 
270 basse ligne Busy de l’interface parallèle. 


&3 dcd de l’entrée-sortie série (ligne 8). 
LME cts de l’entrée-sortie série (ligne 5). 
Sac contrôleur vidéo (fin d’opération) 

£°10 timer D (horloge de cadencement RS 232). 
S214 timer C (horloge système à 200 Hz). 
5718 ACIA 6850 (MIDI et clavier). 

&1C contrôleur de disque et de DMA. 

S120 compteur d’interruptions horizontales. 
5124 erreur à l’émission RS 232. 

3128 tampon d’émission RS 232 plein. 

&2C erreur de réception RS 232. 

150 tampon de réception RS 232 plein. 

S134 timer À (disponible au programmeur). 
S158 indicateur de sonnerie RS 232 (ligne 22). 


S15C haute détection de moniteur monochrome. 


Parmi ces interruptions, seules sont implementés dans le système de base 
ss vecteurs suivants : 


S114 Interruption horloge système 200 Hz. 


Sont effectuées les opérations suivantes : 

— incrémentation du compteur $4BA.L 

— si ce compteur est divisible par 4, donc à la fréquence de 50 Hz, la suite 
de la routine est exécutée. Sinon, retour d'interruption. 

— recherche de commande son éventuelle et envoi (cf. 5.3.). 

— test de l’auto-répétition des touches et si auto-répétition active, décrémen- 
tation du compteur et stockage éventuel de la touche appuyée si le délai 
d’auto-répétition est épuisé. 

— exécution de la routine timer du gestionnaire d'événements AES (cf. 
Annexe 2 : evnt_timer). 
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— désactivation du drapeau d'interruption 68901. 


$118 Interruption ACIA MIDI et clavier. 

Chacun des registres de contrôle ACIA dédié à l’interface MIDI et à l’inter- 
face clavier est testé et, selon le circuit initiateur de l’interruption, soit l’entrée 
MIDI soit l’entrée clavier est prise en compte. La routine de traitement d’entrée 
sur l'interface MIDI se résume à un stockage de l’octet reçu dans le tampon 
MIDI (la fonction TRAP 14, $E, permet de connaître l'adresse de départ 
de ce tampon), avec mise à jour des pointeurs de tampon. 


La routine d’entrée clavier fait l’objet d’une analyse détaillée en 5.2. 
Notons cependant ici que l’ensemble des sous-routines traîtant les interrup- 
tions MIDI et clavier peuvent être modifiées par le programmeur. Il suffit 
d'appeler la fonction $22 du Trap 14 pour obtenir l'adresse de base de la 
liste des pointeurs suivants : 

O.L entrée MIDI voir ci-dessus pour information. 

AL erreur clavier non prise en compte (RTS). 

8.L erreur MIDI non prise en compte (RTS). 

C.L état clavier adresse de la routine de stockage et de traitement de 
l'état du clavier (cf. 5.2., commande $F6) 

10.L position souris adresse de la routine de stockage et de traitement de 
la position et des boutons de la souris. 

14.L horloge stockage de la date et de l’heure. 

18.L manettes de jeu adresse de la routine de stockage et de traitement des 
événements manettes de jeu. 


Les quatre routines ci-dessus seront analysées en 5.2. 
$124 Erreur d'émission RS 232. 


L’octet du registre de contrôle de l'émetteur série est stocké dans $1D 
du tampon RS 232. L’interruption est désactivée. 


$128 Tampon d'émission RS 232 plein. 


En fonction du protocole (CTS/RTS ou XON/XOFF), un signal est envoyé 
ou non demandant l'autorisation de transfert. L’interruption est désactivée. 


$12C Erreur de réception RS 232. 


L’octet du registre de contrôle du récepteur série est stocké dans $1C 
du tampon RS 232. L’interruption est désactivée. 


$130 Tampon de réception RS 232 plein. 


En fonction du protocole, un signal de RTS ou un XON/XOFF est 
envoyé pour arrêt de la transmission. L’interruption est désactivée. 
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Le vecteur $108, correspondant à CTS, n’est initialisé par le système 
&z® si le protocole lui correspondant est validé. D'une façon générale, tous 
ss vecteurs peuvent être modifiés, d’autant que la fonction Mfpint (Trap 
4, SD) est dédiée à ce seul usage. L’interruption timer A est cependant la 
E'ss intéressante à implanter (cf. chapitre 1 et fonction Xbtimer (Trap 14, 
S1F). Il convient, pour tout changement des vecteurs d’interruption, de désac- 
Sver ce vecteur avant modification puis de le réactiver, ceci au moyen des 
Seactions Jdisint (Trap 14, $1B) et Jenabint (Trap 14, $1C). 


5.2. Clavier, souris, horloge et manettes de jeu 


Tous ces périphériques sont gérés par le microprocesseur 6301, lequel 
sénère des interruptions vers le 68901, qui les répercute au 68000. Mais il 
st également possible d’envoyer des demandes d’information ou des com- 
mandes vers le 6301. Les périphériques clavier, souris, horloge et manettes 
de jeu représentent, en dehors des disques, les périphériques les mieux pour- 
+us en fonctions système. En voici la liste : 


Cconin Trap 1, $1 attente d’entrée clavier avec affichage. 
Crawio Trap 1, $6 attente d’entrée « brute » sans affichage. 
Cuecin Trap 1, $8 attente d’entrée clavier sans affichage. 
Cconrs Trap 1, $A attente de chaîne entrée au clavier. 

Cconis Trap 1, $B demande d’état du tampon d’entrée clavier. 
Bconstat Trap 13, $i (param=2) demande état du clavier en entrée. 
Bconin Trap 13, $2  (param=—2) attente d’entrée clavier. 

Bconout Trap 13, $3  (param=4) envoi d’un octet vers le clavier. 
Bcostat Trap 13, $8  (param=4) demande d'état du clavier en sortie. 


Getshift Trap 13, $B activation d’une touche spéciale du clavier, 
Initmous Trap 14, $0  initialisation de la souris. 


Keytbl Trap 14, $10 fixe les adresses des tables de décodage touches. 
Bioskeys Trap 14, $18 replace les adresses système tables de décodage. 
Ikbdws Trap 14, $19 envoi de chaîne vers le clavier (commande). 


Kbdvbase  Trap 14, $22 demande le pointeur des vecteurs clavier. 
Kbdrate Trap 14, $23 fixe la fréquence d’auto-répétition des touches. 


Certaines de ces fonctions font double emploi, par exemple Cnecin et 
Bconin. Il n’a pas été fait état ici des fonctions liées au temps (lecture ou 
écriture de la date et de l’heure), lesquelles dépendent toutes de l'horloge 
du 6301 et des interruptions horloge qu’il génère. Les fonctions d'entrée cla- 
vier étant simples et semblables aux fonctions équivalentes sur les micro- 
ordinateurs, ce sous-chapitre sera consacré aux sorties clavier, c’est-à-dire 
à l’envoi de commandes vers le 6301. 
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L'envoi d’une commande vers le 6301 s’effectue très simplement, en C 
comme en assembleur, à l’aide de la fonction Ikbdws (Trap 14, $19). Il est 
possible d’envoyer plusieurs commandes au 6301 dans une même chaîne mais 
cela ne paraît pas très recommandé pour la lisibilité ultérieure du programme. 


Pour une utilisation ponctuelle, en C comme en assembleur, on pourra 
réserver un tableau de caractères (que nous nommerons ici com_cla) pour 
le stockage des commandes (7 octets par commande au maximum) et un entier 
pour le stockage du nombre d’octets à envoyer (que nous nommerons ici 
Icom_cla). L'appel se fera ensuite par : 


int lcom cla; 
char com clal7]; 


Ikbdust lcom_cla, com_cla )}; en langage C 


et en assembleur par : 


move.l ecom.cla,-(a7) * stacke le contenu de icom_cla  * 
move.w #Hicom_cla,-(a7) * stocke l'adresse de com_cla } 
nove.w ##19,-(a7) * stocke le numero de la fonction * 
trap #14 * exécute Ikbdws * 
addq.1 #8,a7 * restaure le pointeur de pile + 


Les pages qui suivent fournissent la fonction et les conditions d’emploi 
de chacune des commandes pouvant être envoyées au circuit clavier 6301. 
Les commandes provoquent des actions mais également un stockage des para- 
mètres dans la RAM du 6301. Les adresses RAM affectées et la valeur par 
défaut sont fournies en fin de commande. 


Commande $80, Reset 


Commande à securité, doit être suivie de l’envoi de $1 pour être vali- 
dée. L’horloge n’est pas modifiée (elle est initialisée une fois pour toutes lors 
du Reset du 6301, parallèle au Reset du système). Le 6301 renvoie, lors d’une 
commande reset, le numéro de version de la ROM, actuellement $FO0. Toute 
touche enfoncée lors du reset provoque l’envoi par le clavier du code de la 
touche avec le bit 7 à 1. 


Commande 807. Mode de traitement des boutons de la souris 


Doit être suivie d’un octet. Les bits 3 à 7 de cet octet doivent être nuls. 
Si le bit 2 est à 1, les boutons de la souris sont traités comme des touches 
du clavier. Sinon, si le bit 1 est à 1, le relâchement du bouton provoque l’envoi 
de la position absolue de la souris et, si le bit 0 est à 1, La pression sur le 
bouton entraîne l’envoi de la position absolue de la souris. 
(mode stocké dans $B4, valeur par défaut : 0). 
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Commande $08. Déplacements de souris relevés en mode relatif 


Le clavier envoie la position de la souris lorsque le déplacement de celle-ci 
zez rapport à sa position antérieure dépasse une base fixée par la commande 
33 (déplacement horizontal ou vertical) 

‘—ode par défaut, $BC et $BD annulés, $C9 positionné). 


Commande $09. Déplacements de souris autorisés en mode absolu 

Cette commande doit être suivie de 4 octets. Les deux premiers définis- 
sex la position horizontale maximale et les deux suivants la position verti- 
ze maximale. 
{sasit. hor. : SAA et $AB, posit. vert. : SAC et $AD, nuls par défaut). 


Commande $0A. Place la souris en mode clavier (!) 


Suivie de deux octets définissant la distance horizontale puis verticale 
—inimales pour que soit envoyée le code de [LEFT}, (RIGHT), [UP] ou 
DOWN]. Remplace le positionnement relatif ou absolu. Le clavier envoie 
!ss codes équivalents à un appui des touches fléchées lors de déplacements 
&e la souris excédant les intervalles fixes par rapport à la position antérieure. 
Ga. hor. : $AE, int. vert. : $AF, $BA et $BB annulés). 


Commande $0B. Place les intervalles de déplacement de la souris 


Suivie de deux octets indiquant les intervalles horizontaux et verticaux 
minimum pour un envoi de la position de la souris au 68000 (uniquement 
valable en mode de déplacement relatif). 

Œnt. hor. : $BO, int. vert. : $B1, $BC et $BD annulés, intervalles à 1 par 
défaut). 


Commande 80C. Fixe l'échelle de déplacement de la souris en mode absolu 


Suivie de deux octets indiquant les facteurs d’échelle horizontale et ver- 
äcale lors de positionnement absolu, 
{échelle hor. : $B2, échelle vert. : $B3, 1 par défaut). 


Commande $0D. Demande de la position de la souris 


Uniquement valable si la souris est en mode de positionnement absolu. 
Le 6301 renvoie la position suivant le code suivant : 


SF7 en-tête de la souris en positionnement absolue. 

octet bit 0 : à 1 si bouton droit pressé depuis précédente demande 
bit 1 : à 1 si bouton droit relâché depuis précédente demande 
bit 2 : à 1 si bouton gauche pressé depuis précédente demande 
bit 3 : à 1 si bouton gauche relâché depuis précédente demande 
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2 octets indiquant la position horizontale 
2 octets indiquant la position verticale 
(état des boutons dans $C2). 


Commande 80E. Fixe la position absolue de la souris 


Suivie d’un octet nul puis de la position horizontale et de la position 
verticale, chacune sur 2 octets. Place la souris en mode absolu. 
(pos. hor. : $B6-$B7, pos. vert. : $B8-FB9). 


Commande $0F. Place l’origine verticale en bas. 


Valable en mode absolu et relatif. Les mouvements de la souris vers l’uti- 
lisateur deviennent négatifs et positifs dans l’autre sens. 
(bit O de $C9 à 1). 


Commande $10. Place l'origine verticale en haut 


Valable dans les deux modes. Mouvements inverses par rapport à la com- 
mande précédente. 
(bit 0 de $C9 à 0. Position par défaut). 


Commande 811. Réactivation des transmissions 
Inverse de la commande de Pause ($13). 


Commañde $12. Désactive la souris 


Ne désactive que le mode relatif ou absolu, pas le mode clavier (cf. SA). 
Réactivation possible par les commandes $8, $9 et SA. 


Commande 813. Désactivation des transmissions (Pause) 


Transmissions stoppées jusqu’à ce qu’une commande valide soit reçue. 
Les événements continuent à être stockés dans le tampon de 8 octets du 6301. 


Commande 814. Mode événement des manettes de jeu 

Provoque l'envoi d’une commande par le clavier à chaque événement 
(ouverture ou fermeture de contact). Active la manette. La commande envoyée 
par le clavier tient en 2 octets : le premier égal à $FE si manette 0, à $FF 
si manette 1, le second fournit la position sur les bits O à 3 et l'appui du bou- 
ton de « feu » par le bit 7. 
(mode par défaut). 


Commande 815. Mode interrogation des manettes de jeu 


L'envoi de l’état des manettes de jeu n’est fourni que sur demande par 
une commande $16. Active la manette. 
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Commande $16. Interrogation des manettes de jeu 


Demande l’état des manettes de jeu. Le 6301 répond par l’octet $FD 
svi de 2 octets définissant pour la manette 0 et la manette 1 l'appui du bouton 
€ « feu » (bit 7 à 1) et la position (bits O à 3). 


Commande $17. Place le 6301 en mode manettes de jeu 


Dans ce mode, le 6301 contrôle uniquement l'horloge et les manettes 
<e jeu. Cette commande doit être suivie d’un octet indiquant la période d’inter- 
zogation des manettes en centièmes de seconde. A chaque période ainsi défi- 
Le, le 6301 envoie 2 octets, le premier définissant l’état des boutons de feu 
es manettes (bit 1 pour manette 0, bit 0 pour manette 1, autres bits nuls). 
Dans le second octet, les bits 4 à 7 définissent la position de la manette 0 
& les bits 0 à 3 la position de la manette 1. 


Commande $18. Place le 6301 en mode boutons de « feu ». 


Dans ce mode, le 6301 contrôle uniquement l’horloge et le bouton de 
a feu » de la manette de jeu 1. Retourne continûment l’état du bouton dans 
chacun des bits d’une série d’octets, 781 octets, correspondant à 6 250 posi- 
ons, sont envoyés chaque seconde, 


Commande $19. Place la manette de jeu 0 en mode clavier 


Suivie de six octets définis comme suit : 

RX : période, en dixièmes de seconde, avant que le point de déplacement 
horizontal soit atteint. 

RY : période, en dixième de seconde, avant que le point de déplacement ver- 
tical soit atteint. 

TX : période, en dixièmes de seconde, de fermeture du contact avant qu’un 
déplacement horizontal soit signalé. 

TY : période, en dixièmes de seconde, de fermeture du contact avant qu’un 
déplacement vertical soit signalé. 

VX : période, en dixièmes de seconde, de fermeture du contact avant qu'un 
déplacement horizontal soit signalé, après écoulement de RX. 

VY : période, en dixièmes de seconde, de fermeture du contact avant qu’un 
déplacement vertical soit signalé, après écoulement de RY. 


Dans ce mode, la manette de jeu 0 a un effet équivalent aux touches 
du curseur. 
(594, SAI à $A3 annulés). 


Commande S1A. Désactive les manettes de jeu 


Les manettes de jeu peuvent être réactivées par les commandes $14, $15, 
S17, 818 et 519. 
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Commande $1B. Fixe la date et l’heure 


La date et l’heure doivent suivre la commande sur 6 octets (année sur 
2 chiffres significatifs, mois, jour, heure, minutes, secondes). Toutes ces don- 
nées doivent être en BCD (binaire code décimal). Les chiffres non envoyés 
en BCD ne sont pas pris en compte. 
(Place date et heure dans $82 à 587). 


Commande $1C. Demande la date et l’heure 


La date et l’heure courantes sont retournées sur 6 octets (définis comme 
ci-dessus) précédés de l’octet $FC (commande horloge). 


Commande 820. Écriture de données en mémoire vive du 6301 


Suivie de l’adresse de départ (sur 2 octets) où stocker les données, puis 
d’un octet indiquant le nombre de données à écrire, puis des données. 


Commande $21. Lecture de données en mémoire du 6301. 


Suivie de l'adresse de départ (sur 2 octets) à partir. de laquelle lire les 
données. Le 6301 répond par les octets $F6 et $20 de prise en compte de la 
commande puis par 6 octets de données débutant à l’adresse fournie, 


Commande 822. Demande d‘exécution d'une routine du 6301 
Suivie de l’adresse de la routine à exécuter (sur 2 octets). 


Commandes $87 à $8C, $8F, $90, 892, 594, 895, 899 et 89A 


Ces commandes sont des demandes d’état correspondant aux routines 
$07 à $0C, $0F, $10, $12, $14, $15, $19 et $1A. Le 6301 répond par un octet 
de statut ($F6 à $FF) puis sept octets fournissant l’état (avec des octets nuls 
comme remplissage si nécessaire). Ces octets de statut correspondent préci- 
sément aux octets envoyés lors des commandes précédentes : 


commande $87 mode action des boutons de la souris (cf. commande 7). 
commandes $88 à $8A : un octet de mode (8 = relatif, 9 = absolu 
A = clavier), puis 6 octets nuls si mode relatif, 
2 octets d’intervalles horiz. et vertical si mode cla- 
vier puis 4 octets nuls, 4 octets de position hori- 
zontale et verticale et 2 nuls si mode absolu. 
commande $8B intervalles horizontal et vertical et 5 octets nuls. 
commande $8C échelles horizontale et verticale et 5 octets nuls. 
commandes $8F et $90 : retourne $F si Y en bas, $10 si Ÿ en haut. 
commande $92 souris active (0), désactivée (512). 
commande $94 à $95 et $99 : mode manettes de jeu. 
commande $9A manettes actives ($0), désactives ($1A). 
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Les demandes d’état ne sont pas prises en compte si le 6301 se trouve 
en mode manettes de jeu ou en mode bouton de « feu » (commandes $17 
& S18). 


La commande $08 de déplacement relatif de la souris (et les comman- 
&ss $09 à $0C) font intervenir la notion de déplacement de la souris. Ce dépla- ÿ 
ment est repéré sur une échelle interne au 6301 et comptant environ 80 unités 
var centimètres parcouru. La scrutation de la souris est effectuée à une fré- 
‘ uence autorisant des vitesses de déplacement de l’ordre de 25 cm/s (0,9 km/h 
pour les fanas de la vitesse !). En mode relatif, la position de la souris est 
eavoyée au 68000 chaque fois qu’elle dépasse un intervalle horizontal ou ver- 
cal par rapport à sa position antérieure ou lorsque l’état des boutons est 
modifié. En mode absolu, il faut interroger le 6301 pour connaître la posi- 
&on de la souris. En mode clavier, selon le facteur d’échelle, le 6301 envoie Î 
les codes de touches correspondant aux déplacements (les appuis des bou- l 
sons de la souris provoquent dans ce cas l’envoi des codes $74 et $75 au 68000, 
codes clavier, cf. Cconin, Trap 1, fonction $1). 


Le microprocesseur 6301 dispose de vingt octets de mémoire vive pour le 
contrôle des entrées-sorties et des interruptions. Ces mémoires, d'adresse 0 
à $13, ont la fonction suivante : 


00 registre de direction du port 1. i 
01 registre de direction du port 2. 

02 registre d’adresse du port 1. 

03 registre d’adresse du port 2. 

04 registre de direction des données. 

05 registre de direction des adresses. 

06 adresses des 8 lignes de données. 

07 adresses des 8 lignes d’adresses A8 à A15. 

08 registre de contrôle et d’état du timer 6301. 

09-0A compteur de cycles machine (incrémenté toutes les us). 
0B-0C registre de comparaison avec le précédent. 

0D-0E registre de saisie des entrées timer. 

OF registre de contrôle du port 3. 

10 registre de mode et de vitesse de l’interface série rapide. 
11 registre de contrôle et d’état de l’interface série rapide. 

12 registre de lecture des données en série rapide. 

13 registre d'écriture des données en série rapide. 


Ces registres constituent la zone de contrôle du 6301, lequel dispose par 
ailleurs de 128 octets de RAM (d’adresses $80 à $FF) et de 4 Ko de ROM 
(d'adresses $F000 à SFFFF). 
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La carte mémoire vive du 6301 est la suivante : 


$80-$81 
$82 

383 

$84 

$85 

$86 

$87 

$88 
$89-594 
$95 

$96 

$97 

$98 

$99 

$9A 
$9B-$9C 
$9D 
$9E-59F 
$AO-SA3 
$A4 
SAS 
$A6 
$A7 
$A8-$A9 


compteur de millisecondes (décrémenté de $3E8 à O). 
année (en BCD, sur 2 chiffres inférieurs). 

mois, en BCD. 

jour, en BCD. 

heures, en BCD. 

minutes, en BCD. 

secondes, en BCD 

drapeau d’initialisation (à SAA si Reset effectué). 
mémoires de travail pour interruptions. 

RX (voir commande $19). 

RY (voir commande $19). 

TX (voir commande $19). 

TY (voir commande $19). 

VX (voir commande $19). 

VY (voir commande $19). 

mémoires de travail pour scrutation du clavier. 

0 si mode bouton de « feu », sinon compteur interruptions. 
mémoires de travail si mode manettes de jeu. 
mémoires de travail si manettes en mode clavier. 
état courant de la manette 0. 

état courant de la manette 1. 

période de temporisation mode bouton de « feu ». 
période de temporisation mode manettes de jeu. 
mémoires de travail si manettes en mode clavier. 


$AA-$AB position horizontale maximum de la souris (comm. 39). 
$AC-$AD position verticale maximum de la souris (comm. $9). 


$AE 


$BS 
$B6-$B7 
$B8-5B9 
$BA-$BB 
$BC-$BD 
$BE-$C8 
$c9 
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distance horizontale souris en mode clavier (comm. $A). 
distance verticale souris en mode clavier (comm. SA). 
intervalle horizontal souris en mode relatif (comm. $B). 
intervalle vertical souris en mode relatif (comm. $B). 
échelle horizontale de déplacement de souris (comm. $C). 
échelle verticale de déplacement de souris (comm. $C). 
mode de traitement des boutons de la souris (comm. $7). 
mémoire de travail (remplissage commande $E). 
coordonnée horizontale de la souris (comm. $E). 
coordonnée verticale de la souris (comm. $E). 

mémoires de travail si souris en mode clavier. 

mémoires de travail si souris en mode relatif. 

mémoires de travail pour calcul des données à envoyer. 
bit O : à 1 si Y en bas, à 0 si Ÿ en haut (comm. $10, $11). 
bit 1 : à 1 si commande manette, à 0 si commande souris. 


bit 2 : inutilisé. 
bit 3 : à 1 si pause avec empilement des données. 
bit 4 : à 1 si souris en mode relatif. 
bit 5 : à 1 si souris en mode absolu. 
bit 6 : à 1 si souris en mode clavier. 
bit 7 : à 1 si souris active. 

£CA bit 0 : à 1 si en mode bouton de « feu ». 
bit 1 : à 1 si 6301 actif (commande $11). 
bit 2 : à 1 si manettes en mode clavier. 
bit 3 : à L si manettes en mode événement. 
bit 4 : à 1 si manettes en mode interrogation. 
bit 5 : à 1 si manettes actives. 
bits 6 et 7 : inutilisés. 

SCB bits O0 à 2 : compteur d’octets reçus (0 à 7). 
bit 3 : à 1 si Pause (comm. $13). 
bit 4 : drapeau d’erreur « Over-run framing ». 
bit 5 : à 1 si tampon de réception plein. 
bit 6 : à 1 si tampon de réception non vide. 
bit 7 : à 1 si octet en cours de réception. 


SCC compteur d’octets du tampon de réception. 

SCD-$D3 TAMPON DE RÉCEPTION DES DONNÉES 68000 (7 octets). 
SD4 compteur d’interruptions non prises en compte. 

SD5 compteur de boucle pour stockage dans le tampon. 

SD6 compteur de numéro d’octet à envoyer. 

SD7 nombre d’octets à émettre. 

SD8 compteur de comparaison avec nombre octets à émettre. 


SD9-$ED TAMPON D’'ÉMISSION VERS LE 68000 (20 octets), 
SEE-$EF stockage d’adresse (commandes $20 et $21). 

SFO stockage nombre octets à recevoir (commande #20). 
SFI-SFF PILE du 6301. 


Ces informations pourraient paraître superflues si la commande $21 ne 
permettait de lire des données dans la mémoire vive du 6301. IL est ainsi pos- 
sible, par exemple, de disposer d’un compteur au millième de seconde (comp- 
teur situé en $80-581, réinitialisé à $3E8 chaque seconde et décrémenté cha- 
que milliseconde). Il suffit pour cela d’appeler : 


Ikbdws (2, com_cla) avec com_cla[0] = #21, 


La réponse est alors obtenue par lecture des sorties clavier, les deux pre- 
miers octets étant des codes de commandes ($F6 et 520), les deux octets sui- 
vants fournissant la valeur du compteur et les quatre suivants pouvant être 
négligés (contenu des mémoires $82 à $85). 
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Il est même possible de disposer d’un compteur de millionièmes de 
seconde (situé en $9 et $A, remis à $3E8 chaque millième de seconde et décré- 
menté), mais ce compteur est pratiquement inutilisable, la vitesse de trans- 
mission série rapide (7 812,5 bits/s) étant trop faible. 


La commande $20 autorisant l'écriture en mémoire vive du 6301, il est 
possible de reconfigurer tous les paramètres de gestion de la souris et des 
manettes en modifiant le contenu des mémoires $95 à $CB. Cette manipula- 
tion directe du 6301 reste toutefois réservée aux connaisseurs. 


L'intérêt de la commande $22, autorisant l'exécution d’une routine du 
6301, est plus que discutable à moins que l’on ne désire « planter » le circuit 
clavier. D'autant que vous ne trouverez nulle part les adresses ROM des 
routines du 6301 ! A titre informatif, en voici quelques-unes, même si leur 
utilisation est peu recommandable ! 


$F000 Reset froid (annule l’horloge). 
$F00B Reset chaud (conserve l’horloge). 
$F9D1 exécution de la commande #11. 
$F9DD exécution de la commande $13. 
$F9EF exécution de la commande $14. 
$F9F3 exécution de la commande $15. 
$FO9FA exécution de la commande $16. 
$FA3E exécution de la commande $18. 
$FA77 exécution de la commande $1A. 
$FACE exécution de la commande $1C. 
$FAF4 exécution de la commande $8. 
SFBCA4 exécution de la commande $F. 
$FBC9 exécution de la commande $10. 
$FBCE exécution de la commande $12. 


Les routines d’interruption timer et d’interruption série sont placées res- 
pectivement en $FDE9 et $FF23. Encore faut-il souligner que ces adresses 
sont valables pour la version $F0 de la ROM du 6301, inchangée de l’appa- 
rition du 520 ST à janvier 1986 mais susceptible d’être mise à jour. 


5.3. Programmation du synthétiseur de son 


Les caractéristiques matérielles du circuit synthétiseur de son ont été pré- 
sentées au chapitre 1 (1.1.3). La description des différents registres, si elle 
constitue le point de départ obligé pour toute programmation de sons, nécessite 
toutefois d’être illustrée d'exemples, raison de ce sous-chapitre. 
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La pré-version du Basic, diffusée à l'heure où sont écrites ces lignes, 
permet d’offrir un aperçu des possibilités sonores du 520 ST. Le court pro- 
gramme suivant exécute la gamme sur 8 octaves successifs : 


20 for i = 1 to 8 
30 for j = 1 to 12 
40 sound 1,15,3,1,10 
S0 next ; 

€0 nent i 

70 wave © 


Si ce programme ne produit aucun son, il vous est conseillé de régler 
la hauteur du son sur le moniteur ! Si vous estimez que le son pourrait être 
plus mélodieux, ajoutez au programme précédent la ligne : 


10 wave 1,1,9,5000, À 


Les instructions Basic SOUND et WAVE (son et enveloppe en français) 
fonctionnent avec les paramètres suivants : 


SOUND <adresse> ou <adresse> est l'adresse d’une suite de comman- 
des envoyées au circuit son. 


SOUND suivi de 2 à 5 paramètres avec les significations : 
1# paramètre : numéro du canal (1 à 4) 
2e paramètre : volume du son (0 à 15) 
3e paramètre : note (1 à 12) 
4e paramètre : octave (1 à 8) 
5e paramètre : temporisation après le son (0 à 65535). 


WAVE suivi de 1 à 5 paramètres avec les significations : 

1e paramètre : nombre compris entre 0 et 63 
bit 0 : à 1 valide le canal A 
bit 1 : à 1 valide le canal B 
bit 2 : à 1 valide le canal C 
bit 3 : à 1 mixte le canal de bruit et A 
bit 5 : à 1 mixte le canal de bruit et B 
bit 5 : à 1 mixte le canal de bruit et C 

2° paramètre : nombre compris entre 0 et 7 
bit 0 : à 1 valide l’enveloppe pour À 
bit 1 : à 1 valide l’enveloppe pour B 
bit 2 : à 1 valide l’enveloppe pour C 
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3° paramètre : type de l’enveloppe (0 à 15) 
4 paramètre : période de l’enveloppe (0 à 65535) 
5° paramètre : temporisation après commande WAVE. 


Les paramètres de WAVE correspondent au registre 6 pour le premier, 
aux bits 4 des registres 8, 9 et SA pour le deuxième, au registre $D pour le 
troisième, aux registres $B et $C pour le quatrième. La temporisation, en 
5° paramètre des commandes SOUND et WAVE correspond à l’envoi d’un 
certain nombre de demandes de délai (commande $FF de Trap 14, fonction 
$20). La temporisation est exprimée en cinquantièmes de seconde. Dans la 
commande SOUND, le premier paramètre correspond au numéro de canal 
( = À,2 = B,3 = C) ou au canal de bruit (4). Dans ce dernier cas, le 
troisième paramètre n’est pas pris en compte et le cinquième désigne la période 
(0 à 15), correspondant au registre 6 du circuit son. 


La note, stockée comme troisième paramètre de SOUND, correspond 
à un ton de la gamme diatonique majeure (1 = DO, 2 = DO dièse, 3 = 
RE, 4 = MI bémol, 5 = MI, 6 = FA, 7 = FA dièse, 8 = SOL, 9 = LA 
bémol, 10 = LA, 11 = Si bémol et 12 =SI). Les octaves 1 à 8 correspon- 
dent à des fréquences s’échelonnant entre 32.7 Hz et 7 812.5 Hz (donc sur 
une gamme réduite mais bien suffisante). Le LA international (à 440 Hz) 
correspond au LA (note 10) de l’octave 4, 


On notera que pour envoyer des sons sur plusieurs canaux il est néces- 
saire d’employer une commande SOUND par canal, un mixage pouvant 
ensuite être effectué par le biais de la commande WAVE. On relèvera égale- 
ment que la commande WAVE 0 à pour effet de désactiver la sortie son 
puisqu'elle désactive les trois canaux de tons et les mixages éventuels avec 
le canal de bruit. 


La programmation de sons, bruits ou mélodies, en langage C comme 
en assembleur, dépend étroitement du but recherché. Si l’on désire produire 
des sons ou des séquences de sons identiques, la meilleure méthode consiste 
à stocker ces sons ou ces séquences sous forme de chaînes de mots, chacun 
des mots comportant le numéro du registre son concerné dans l’octet fort 
et la valeur à placer dans ce registre dans l’octet faible. Cette chaîne doit 
se terminer par le mot $FF00 (indicateur de fin de chaîne son). Son adresse 
peut alors être envoyée comme paramètre de l’instruction Dosound (Trap 
14, fonction $20). 


Si l’on désire produire des sons divers et peu répétitifs (pour une mélo- 
die, par exemple), il semble préférable de programmer une procédure C dans 
ce seul but, procédure dont les paramètres d’entrée autoriseront un appel 
humaïnement acceptable des différents sons ! On pourra même, si le son est 
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tm élément déterminant du programme, créer plusieurs sous-routines dédiées 
à la « traduction » de tel ou tel paramètre sonore. 


À titre d'exemple, voici une routine en langage C dont Les paramètres 
é’entrée sont la note et l’octave et qui retourne l’entier servant au codage 
&e la période dans les registres correspondants du canal : 


dat 
cenvireq(note, octave) 
ist note; 
int actave; 
LA 
int  minoct; 
long varbase} 
séatic long freqbasef123 = { 4266449, 4541383, 4811591, 5097921, 
5400580, 5721817, 6061949, 6422597, 
6804541, 7208960, 7657565, 4091750 2} 


if (note <1) note = 1; /* traitement d'erreurs #/ 
if {note 12) note = 12; 4* pouvant ëtre supprimé */ 
1 (actave <1) octave # 1} /% s’il ne semble pas */ 
if (octave DB) actave = 8j /* indispensable */ 


varbase = freqhase € note - 1 ]; 
minoct = 8 - octaves 

varbase = ( varbase >> minoct )}; 
return ( 128000000/varbase); 


Cette routine a été testée et utilisée dans plusieurs programmes. L’entier 
retourné doit être séparé en deux octets, l’octet fort étant placé dans le regis- 
tre 1 et l’octet faible dans le registre O pour le canal A (registres 3 et 2 pour 
le canal B, 5 et 4 pour Le canal C). Le tableau fregbase{] correspond aux divi- 
dendes pour les notes DO à SI du 8° octave, Rappelons que la fréquence d’un 
son est égale à : 125 000/ton, le ton étant le contenu placé dans les registres, 
en l’occurrence le paramètre de retour de la fonction convfreq(). 


La fréquence de l’enveloppe, correspondant aux registres $B et $C de 
la puce son (octet fort en $C et octet faible en $B), est fournie par : 


valeur en Hz = 7 812.5 / (contenu des registres $B et $C) 


Il est ainsi possible de faire varier la fréquence de l’enveloppe entre 
7812.5 Hz et 0.119 Hz, valeurs correspondant à des périodes de 128 micro- 
secondes à 8.39 secondes. La routine C suivante propose un exemple de stoc- 
kage de valeur dans les registres de période d’enveloppe $B et $C. Le para- 
mètre d’appel « chaîneson » correspond à un pointeur de chaîne, chaîne dans 
laquelle sont stockées les commandes à envoyer au circuit son, tandis que 
le paramètre d’appel période désigne la durée désirée de la période d’enve- 
loppe en millisecondes, durée de base suffisante pour la plupart des 
enveloppes. 
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stocper_env(chaineson, période) 
long chaineson; 

int période; 

{ 


int acthaut,octbas; 


if (période > 8388) periode = 8388; 
période = (période * 7.8125); 

octhaut = (période >> 8); 

actbas = période - (258 * octhaut)s 
octhaut += 0x0C00; 

octbas += 0x0B00; 

€ xtGint #) (chaineson)) # acthaut); 

{ ttGint #) (chaineson + 2)) = octbas); 
thaineson += 4; 


La programmation de sons en C comme en assembleur passe par Putili- 
sation de la fonction Dosound (Trap 14, $20), dont l’unique paramètre d’appel 
est un pointeur de chaîne, chaîne dans laquelle sont stockés successivement 
les numéros de registres et les valeurs à y placer. Dans le TOS, la fonction 
Dosound est traitée de façon fort brève : le pointeur de chaîne est stockée 
dans une variable système que nous nommerons _ptrson et une autre varia- 
ble système (octet que nous nommerons _timerson) est réinitialisée à 0. Au cas 
où le pointeur de chaîne fourni en appel est négatif, la fonction Dosound 
retourne le contenu courant de _ptrson. 


À ce stade, aucun son n’est produit ni même pris en compte ! Tout com- 
mence lors de l'interruption horloge système suivante (fréquence : toutes les 
20 ms). La variable _ptrson est testée. Si elle est nulle (pas de son en attente), 
fin de la routine. Sinon, la variable _timerson est testée, Si elle est positive 
(temporisation), elle est décrémentée de 1 et fin de la routine. Si elle est nulle, 
le premier octet de la chaîne son est pris en compte. Plusieurs cas peuvent 
alors se présenter : 


1) Cet octet est positif, il est alors considéré comme un numéro de regisre, 
avec masquage des seuls bits concernés. L’octet suivant, donnée à placer dans 
le registre, est envoyé dans celui-ci par écriture de $FF8802 (cf. Annexe 3). 
2) Cet octet est compris entre $82 et $FF. Il initialise une temporisation. 
L’octet suivant est saisi et placé dans _timerson, il produit une temporisation 
égale à : 20 ms + valeur de l’octet. Si l’octet est nul (temporisation nulle), 
la variable ptrson est remise à 0 (fin de chaîne). 

3) Cet octet est égal à $80. L’octet suivant est stocké dans une variable système 
de réserve que nous nommerons _réserve. 

4) Cet octet est égal à $81. 11 s’agit alors d’une commande à 3 arguments. 
Le premier argument est le numéro du registre à charger avec la valeur _ réserve 
précédemment placée par la commande $80. Le second argument est une 
valeur d’incrémentation (valeur qui sera ajoutée au premier argument). Le 
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« printf » ou « scanf », de par leur volonté hégémonique, n’exploitent 
qu’assez peu les possiblités graphiques d’une machine comme le ST. Et si 
le GEM autorise une gestion plus souple et mieux appropriée (le contraire 


serait surprenant !), certaines fonctions système gardent leurs spécificités. 


L’étude précédente des périphériques clavier et synthétiseur a montré 
comment il était possible de dépasser les structures parfois contraignantes 
du GEM. D’autres horizons sont ouverts par la programmation de l’inter- 
face série, dont il a été superficiellement traité au chapitre 1, de l’interface 
MIDI ou parallèle. Les programmeurs apprécieront par exemple la fonction 
$24 du Trap 14, laquelle autorise des copies d’écran partielles et personnali- 
sées (par le biais de la table de conversion des couleurs). 


D'une façon générale toute programmation fine des entrées-sorties devra 
passer sous les fourches caudines du Trap 14, véritable mine autorisant une 
exploitation complète des potentialités du 520 ST. On ne saurait donc trop 
recommander l'étude attentive de ces fonctions système ! Le programmeur 
en assembleur pourra aussi user de la ligne « A », et prochainement de la 
ligne « F » (cf. chapitre 3), lesquelles contribuent à réduire considérablement 
le code objet et apportent rapidité et confort dans la programmation et 
lPexécution. 


Le lecteur pourra s'étonner du manque d'informations sur la gestion des 
disquettes et du disque dur mais, d’une part le disque dur n’a pu être analysé 
par l’auteur avant la remise du manuscrit, d’autre part ce sujet mériterait 
à lui seul un ouvrage, à paraître peut-être. Plusieurs fonctions système (tou- 
jours Trap 14 !} permettent d’exécuter la lecture, l'écriture ou le formatage 
de secteur(s) ou de piste. Ces fonctions sont détaillées en Annexe 4 et nous 
prions le lecteur intéressé de s’y reporter. 


Les adresses système et spécialement les adresses physiquement liées à 
des périphériques d’entrée-sortie fournissent un second filon, presqu’inépui- 
sable, pour la programmation. Rappelons toutefois qu’il est indispensable 
de se trouver en mode SUPERVISEUR pour lire et écrire des variables 
système, Aussi est-il parfois plus économique d’appeler par exemple la fonc- 
tion Logbase (Trap 14, fonction 2) pour connaître l’adresse de base de la 
mémoire d'écran plutôt que de passer en mode superviseur, de demander 
le contenu de la variable système $44E.L, puis de repasser en mode utilisateur. 


Pour des lectures ou écritures multiples de variables système, une possi- 
bilité intéressante est offert par Trap 14, fonction $26, qui autorise l’exécu- 
tion d’une de vos routines en mode Trap. Il suffit donc de passer en para- 
mètre d’appel l’adresse de votre routine de lecture ou écriture de variables 
système, puis d’appeler Trap 14, fonction $26. Votre routine se terminera 
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ANNEXE 71. 
FONCTIONS C STANDARD 


Les fonctions suivantes appartiennent à la bibliothèque standard du C. 
Leur utilisation dans un programme suppose l’édition de liens avec « GEM- 
LIB » et, bien souvent, « LIBF ». Seules les fonctions implémentées sur le 
compilateur de Digital Research font l’objet de cette nomenclature. On notera 
à ce propos que certaines fonctions appartenant à la liste des fonctions dis- 
ponibles sur ce compilateur ne sont pas implémentées sur les 520 ST et donc 
non étudiées ici. Les fonctions sont classées par ordre alphabétique, le mode 
d’appel de la fonction ne comportant pas la longueur des paramètres, cette 
dernière étant indiquée à la suite de chacun des paramètres. 


abort. abort (code) 


Provoque l'arrêt du programme avec code d’erreur. Utilisé pour « débu- 
guer » un programme à l’aide de SID. 


int code : code placé dans le registre DO avant l’appel. 


abs, ret = abs (valeur) 


Fournit la valeur absolue de l’argument entier (cf. fabs). Définie comme 
macro dans « stdio.h » sous la forme : ((x) < 0? — (x) : (x)). Simple, non ? 


int valeur : argument en entrée. 
int ret : valeur absolue de l’argument en entrée. 


access. ret = access (nom, mode) 


Recherche la possibilité d’accès à un fichier. Pour un nom et un type 
de fichier donné, est-il possible d’y accéder ? 


char «nom: pointe la chaîne du nom de fichier. 
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int type : 4 pour vérifier l’accès en lecture, 2 en écriture, 
1 pour vérifier qu’il s’agit d’un fichier exécutable. 
int ret : 0 si l'accès est possible sous ce mode, — 1 sinon. 


atoi, atof, atol. valeur = atoi (chaîne) 


Conversion d’une chaîne ASCII en entier (atoi), flottant (atof) ou entier 
long (atol). ATTENTION, le débordement n’est pas détecté. 


char «chaîne : chaîne ASCII devant se terminer par un caractère nul. 
valeur : int si atoi, float si atof, long si atol. 


brk, sbrk ret = brk (adresse) début = sbrk (taille) 

Gèrent l’espace réservé à l’application. La fonction brk fixe la limite 
haute de la zone réservée. La fonction sbrk permet d’étendre cette zone. Dans 
le compilateur de D.R., « gemstart » commence par l’appel de brk. 


char +adresse : adresse désirée du haut de l'application. 

int taille : nombre d’octets à ajouter à la zone réservée. 

char «début : adresse de départ de la nouvelle zone réservée (0 si la fonc- 
tion sbrk n’a pu être exécutée). 


calloc, malloc, realloc, free, adresse = malloc (taille) 
adresse = calloc (nombre, taille), realloc (adresse, taille) free (adresse) 


La fonction malloc alloue une zone de mémoire de « taille » octets. La 
fonction free libère cette zone allouée. La fonction calloc alloue « nombre » 
fois la « taille » précisée (allocation pour tableaux ou structures). La fonc- 
tion realloc change la taille d’une zone allouée. ATTENTION, la taille de 
la zone est un entier, donc inférieure à 65 536 octets. 


char xadresse : adresse de la zone à allouer ou ré-allouer. 
int taille : nombre d’octets à allouer. 
int nombre : nombre d’éléments pour « calloc ». 


ceil ret = ceil (valeur) 


Fournit l’entier arrondi par excès d’une valeur flottante. Cet entier est 
stocké sous forme de nombre flottant (cf. floor). 


float valeur, ret : argument et résultat flottants. 


chmod, chown. ret — chmod (nom, mode) ret = chown (nom, prop, groupe) 
Primitives UNIX non prises en compte par le compilateur € de D. K. 
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aase. ret = close (id_fich) 
Fermeture d’un fichier dont id_fich est l’identificateur (voir creat). 


 fd, ret : identificateur et retour (0 si OK, — 1 sinon), 


ces, sin, ret = cos (valeur ret = sinus (valeur) 
Fournit le cosinus (ou le sinus) d’un flottant exprimé en radians. 


Soat valeur, ret : argument et résultat. 


craft, creata, creatb. id_fich = creat (nom, mode) 


Ajoute un fichier à un catalogue disquette. Les fonctions creat et creata 
soat identiques et créent un fichier ASCII. La fonction creatb crée un fichier 
maire. Voir open, close, read et write. 


char +n0m : pointe la chaîne de stockage du nom de fichier, 
int mode : non pris en compte (0 par exemple). 
ni id_fich : identificateur du fichier (A CONSERVER !). 


etoa, ftoa. ret = etoa (val, tamp, prec) ret = ftoa (val, tamp, prec) 
Conversion d’un nombre flottant en chaîne ASCII. Fonctions identiques. 


float val : valeur flottante à convertir. 

char *tamp : adresse du tampon de stockage de la chaîne résultat, 
int prec : précision (nombre de chiffre après la virgule, 0 à 5). 
char #ret : adresse de la chaîne résultat (identique à tamp). 


exit,_exit. exit (code) _exit(code) 


La fonction exit provoque une sortie du programme avec fermeture des 
fichiers ouverts et désallocation des zones de mémoire allouées. La fonction 
_exit est identique mais sans fermeture ou désallocation. 


int code : valeur retournée après sortie du programme. 
exp. ret = exp (val) 
Fournit l’exponentielle d’une valeur flottante. 
float val, ret : argument et résultat foftants. 
fabs. ret = fabs (val) 
Fournit la valeur absolue d’une valeur flottante (cf. abs). 


float val, ret : argument et résultat flottants. 
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fclose, fflush. ret = fclose (canal) ret = fflush (canal) 
Respectivement fermeture et vidage des tampons d’un canal (cf. fopen). 


FILE «canal : structure de données sur le canal (voir fopen). 
int ret : 0 si OK, — 1 si l'adresse de canal est erronée. 


feof, ferror, clearerr, fileno. ret = feof (canal) ret = ferror (canal) 
clearerr (canal) descr = fileno (canal) 

Manipulation directe de canal. «feof » effectue un test de fin de fichier. 
« ferror » effectue un test d’erreur et « clearerr » supprime cette erreur. 
« fileno » renvoie le descripteur du fichier associé au canal. 


FILE «canal : structure de données sur le canal (voir fopen). 
int ret : 0 pour « feof » si fichier non terminé. 
int descr : descripteur de fichier. 


floor. ret = floor (valeur) 
Retourne l’entier arrondi par défaut d’un flottant (cf. ceil). 


float valeur, ret : argument et résultat floftants. 


fmod, ret = fmod (a, b) 
Fournit le reste de la division de a par b (le « modulo »). 


float a,b, ret : a est le diviseur, b est le dividende, ret le reste. 


fopen, freopen, fdopen. canal = fopen (nom, accès) canal = fdopen (descr, 
access) ’ 

Association d’un canal avec un fichier. « fopen » et « fopena » asso- 
cient un fichier ASCII à un canal, « fopen » associe un fichier binaire. « freo- 
pen » et « freopena » substituent un nouveau fichier ASCII à un canal ouvert 
(« fopenb » pour un fichier binaire). « fdopen » associe un fichier déjà ouvert 
à un canal. 


La structure FILE est définie ainsi : 


int _fd descripteur de fichier. 

int flag drapeau d’erreur ou de fin de fichier. 

char *_base pointe la base du tampon du fichier. 

char + ptr pointe la position courante dans le tampon. 
int count nombre de caractères à lire ou écrits. 


FILE xcanal : structure de données sur le canal. 
char «nom  : pointe la chaîne du nom de fichier. 
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Æ= +access : pointe la chaîne « r » si lecture, « w » si écriture, « a » si ajout 
à un fichier. 
2 descr : descripteur de fichier (voir fileno). 


cad, fwrite, fread (tamp, taille, nombre, canal) 
Lecture ou écriture d’octets d’un canal vers la mémoire. 


zx stamp : pointe le début du tampon en mémoire. 
‘Ei taille : nombre d’octets dans chaque item. 
= nombre : nombre d’items à lire ou écrire. 


EILE «canal : structure de données du canal (voir fopen). 


Esek, ftell, rewind. ret = fseek (canal, dep, type) 
sp = ftell (canal) ret = rewind (canal) 

Positionnement du pointeur de canal. « fseek » positionne le pointeur, 
« ftell » fournit la position et « rewind » place le pointeur en début de canal. 


FILE «canal  : structure de données du canal (voir fopen). 


Tong dep : nombre d’octets du déplacement du pointeur. 

Int type : type de déplacement (0: à partir du début du fichier, 1 : 
à partir de la position courante, 2 : à partir de fin). 

ni ret : 0 si OK, —1 sinon. 


getc, getchar, fgetc, getw, getl. carac = getc (canal) 

Lecture de caractère à partir d’un canal (getc et fgetc : lecture d’un seul 
caractère |getchar à partir de la console] ; getw : lecture d’un entier 16 bits : 
getl : lecture d’un long mot 32 bits). 


FILE «canal  : structure de données du canal (voir fopen). 
carac : char si getc ou fgetc, int si getw, long si getl. 


getpass. mot = getpass (chaîne) 

Lit un « mot de passe » entré au clavier. « chaîne » est affiché et un 
curseur apparaît. Les caractères entrés ne sont pas affichés. Huit caractères 
au maximum peuvent être entrés. 


char «chaîne  : pointe la chaîne affichée. 
char «mot : pointe le mot lu au clavier. 


gets, fgets. adresse = gets(s) adresse = fgets (s, n, canal) 

Lecture de chaînes à partir d’un canal. « fgets » lit une chaîne terminée 
par un retour de chariot, « gets » supprime le code de chariot et ne lit que 
sur le canal clavier. 
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char +adresse : pointe l’adresse de stockage de la chaîne, 
char *s : pointe le tampon de stockage. 

intn : nombre maximum d’octets à lire. 

FILE xcanal : structure de données sur le canal (voir fopen). 


index, rindex. adresse = index (chaîne, code) 
Recherche d’un caractère dans une chaîne (index fournit la première 
occurrence et rindex la dernière). 


char «chaîne : pointe la chaîne ou rechercher le caractère. 
char code : code du caractère à rechercher. 
char xadresse : adresse du caractère recherché, 


isatty. ret = isatty (id_fich) 
Teste si un fichier est lié au clavier ou non. 


int id_fich : identificateur de fichier (voir open). 
int ret : 1 si fichier lié au clavier, 0 sinon. 


log. ret = log (valeur) 
Fournit le logarithme néperien d’une valeur flottante. 


float valeur, ret : argument et résultat flottants. 


Iseek, tell. ret = Iseek (id_fich, dep, type) ret = tell (id_fich) 
« lseek » positionne et « tell » fournit la position d’un pointeur de fichier 
(correspondant à fseek et ftell pour un canal). 
int id_fich : identificateur de fichier (voir open). 
long dep : nombre d’octets du déplacement de la position. 


int type : 0, 1 ou 2 (voir fseek). 
lont ret : position absolue si ftell, —1 si erreur. 


mktemp. chaîne = mktemp (chaîne) 

Création d’un nom de fichier temporaire. A l’appel, « chaîne » pointe 
sur une chaîne se terminant par XXXXXX. Au retour ces caractères sont 
recouverts par le nom temporaire, 
char «chaîne : pointe la chaîne calibrée puis modifiée. 
open, opena, openb. id fich = open (nom, mode) 

Ouverture d’un fichier ASCII pour fopen et fopena, binaire pour fopenb. 
char «nom : pointe la chaîne de stockage du nom de fichier. 
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int mode : O en lecture, 1 en écriture, 2 en lecture/écriture. 
int id_fich : identificateur de fichier (A CONSERVER !). 


perror. erreur = perror (chaîne) 
Affiche un message d’erreur décrivant la dernière erreur rencontrée. 


char «chaîne : pointe la chaîne à afficher. 
int erreur : numéro de l’erreur lors de l’appel. 


pow. ret = pow(x,y) 
Fournit la valeur de x à la puissance yÿ. 
float x, y, ret : arguments et résultats flortants. 


printf, fprintf, sprintf printf (chaîne, argl, arg2,.…) 

fprintf (canal, chaîne, argl, arg2,.…) sptintf (canal, chaîne, argl..…) 
“printf”’ affiche une chaîne formatée, Sfprintf”? sort une chaîne sur un canal 
donné, ‘‘sprintf”” place une chaîne en mémoire. Le symbole % dans la chaîne 
formatée indique un opérateur, le caractère le suivant indiquant le type de 
l'opérateur (d = nombre décimal en ACSII, o= nombre binaire en octal ASCII 
x=nombre binaire en hexadécimal ASCII, c=nombre en simple caractère, 
s=nombre en adresse de chaîne, u=nombre décimal non signé en ASCID. 


char «chaîne : chaîne formatée avec opérateurs éventuels. 
argl, arg2.. : arguments de conversion pour opérateurs. 
FILE «canal : structure de données décrivant le canal (cf. fopen). 


pute, putchar, fpute, putw, putl. ret = putc (car,canal) 


Sortie d’un caractère à l’écran (putchar), sur un canal (putc, fputc). 
Sortie d’un mot de 16 bits avec putw, de 32 bits avec putl. 


char car : caractère à sortir. 
FILE «canal: structure de données décrivant le canal (cf. fopen). 
int ret : caractère placé (LONG si putl), —1 si erreur. 


puts, fputs. ret = puts (chaîne) ret = fputs (chaîne,canal) 
Sortie d’une chaîne terminée par un caractère nul à l’écran avec retour de 
chariot (puts) ou sur un canal sans retour à la ligne (fputs). 


char +chaîne : pointe la chaîne à afficher. 
FILE «canal : structure de données décrivant le canal (cf. fopen). 
int ret : dernier caractère sorti, —1 si erreur. 


qsort. qsort (base, nombre, taille, compare). 
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Tri rapide de « nombre » éléments comportant « taille » octets et stoc- 
kés à partir de « base », « compare » est l’adresse d’une routine de compa- 
raison du type “‘ret = compare (a, b)”?, renvoyant — 1sia<b,0sia = 
b,isia>b. 


char «base : adresse de départ du tableau à trier. 
int nombre  : nombre d’éléments à trier. 
int taille : taille de chaque élément. 


int compare() : adresse de la routine de comparaison. 
rand, srand. alea = randO alea = srand (semence) 


Fournit un nombre pseudo-aléatoire quelconque (rand) ou déduit d’une 
« semence » (srand). 


int semence, ret : argument éventuel et résultat entiers. 


read. ret = read (id_fich, tampon, nombre) 
Lecture d’octets dans un fichier (voir open et creat). 


int id_fich : identificateur de fichier (voir open). 

char «tampon : pointe le tampon où stocker les données lues. 
int nombre : nombre d’octets à lire. 

int ret : nombre d’octets lus, — 1 si erreur. 


scanf, fscanf, sscanf. nombre = scanf (chaîne, argl, arg2, …) 


nombre = fscanf (canal, chaîne, argl, ….) nombre =sscanf (chi, chaîne, 
argl, .…) 

Conversion de chaîne entrée au clavier (scanf), sur un canal (fscanf) ou 
à partir d’une chaîne (scanf). Voir « printf » pour les formats. 


char +chaîne : chaîne formatée (voir printf). 

char *ch1 : chaïne d’origine pour sscanf. 

FILE «canal : structure de données décrivant le canal (cf. fopen). 
argi, arg2 : données pour opérateurs de formatage. 

int nombre : nombre de données converties. 


setjimp, longjmp. ret = setjmp (env) longimp (env, ret) 

Autorise un GOTO externe à une procédure, « env. » doit pointer un 
tampon de 50 octets, « ret » fournit un identificateur. À partir de ces deux 
paramètres, la fonction « longjmp » permet un saut du programme à l’ins- 
truction suivant setimp avec des registres identiques à ceux de l’appel de 
setjmp. 


146 


char xenv : adresse d’un tampon de 50 octets minimum. 
int ret : identificateur de saut 


signal, ret = signal (numéro, fonc) 

Permet de faire correspondre une routine C à une exception 68000 (indi- 
quée par « numéro » : 4 =illégal, 5 = trace, 6 = traps différents de 2 et 
3, 8 = division par 0, TRAPV et CHECK, 10 = erreur de bus). 


int signal : numéro de l’exception (voir ci-dessus). 
int fonc() : adresse de la routine C,. 
int ret : 0 si OK, — 1 si numéro non autorisé. 


[ 


sart, ret = sqrt (valeur) 
Fournit la racine carrée d’un nombre flottant. 


float valeur, ret : argument et résultats floftants. 


strcat. strncat. ret — strcat (S1, S2) ret = strcat (sl, s2, n) 
Concaténation de chaînes. « strncat » n’ajoute à si que n caractères de s2. 


char xs1, +52 : pointent les chaînes à concaténer. 
int n : nombre d’octets à ajouter pour stncat. 
char #ret : pointe le début de la chaîne concaténée. 


stremp, stnemp. val = stremp (s1, s2) val = strncmp (sl, s2, n) 
Comparaison de chaînes, sur n caractères pour « strncmp ». 

intn : nombre de caractères à comparer si strncmp. 

int ret : — sisi < 52, 0 si sl = 52, 1 si si > 92, 


strepy, strncpy. ret = strepy (sl, s2) ret = strncpy (sl, s2, n) 
Copie d’une chaîne, sur n caractèress si « strncpy ». 


char «si, «s2 : pointent la chaîne à copier et la chaîne copiée. 


intn : nombre de caractères à copier si strncpy. 
char xret : pointe le début de la chaîne s1. 


strlen. longueur =strlen(s) 
Fournit la longueur d’une chaîne, 


char *s : pointe la chaîne. 
int longueur : longueur de la chaîne. 


swab. ret = swab (source, dest, nombre): 
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Copie une zone de mémoire dans une autre avec inversion des octets 
faibles et forts (utile pour conversion de données 8086 en 68000). 


char +source : pointe la zone de mémoire à copier. 
char «dest : pointe la zone de mémoire où copier. 
int nombre : nombre PAIR d’octets à copier. 


tan, atan. ret = tan (valeur) ret = atan (valeur) 
Fournissent la tangente ou l’arc tangente d’un nombre flottant. 


float valeur, ret : argument et résultat floftants. 


ttyname. nom = ttyname (id_fich) 
Retourne un pointeur sur la chaîne « CON: » si le fichier est affecté 
au clavier, une chaîne nulle sinon. 


int id_fiche : identificateur de fichier (voir open). 
char «nom : pointe la chaîne résultat (« CON: » ou nulle). 


ungete. ret = ungetc (car, canal) | 
Place un caractère dans le tampon d'entrée d’un canal. Ce caractère sera 
donc disponible au prochain appel « getc ». < 


char car : caractère à forcer dans le tampon d’entrée. 
FILE +canal : structure de données décrivant le canal (cf. fopen). 
int ret : le caractère si ok, — 1 sinon. 


unlink. ret = unlink (nom) 


Effacement d’un nom de fichier si celui-ci existe et n’est pas ouvert. 
char «nom  : pointe la chaîne du nom du fichier. 
int ret : O si ok, — 1 si erreur. 


write, ret = write (id_fich, tampon, nombre) 
Écriture de données dans un fichier ouvert. L'écriture a lieu 1à où est 


positionné le pointeur de fichier (voir lseek). Attention, l'écriture dans le fichier 
n’est certaine qu’une fois celui-ci fermé. 


int id_fich : identificateur de fichier (voir open). 


char «tampon : pointe le tampon où sont stockées les données à écrire. 


int nombre : nombre d’octets à écrire. 
int ret : nombre d’octets écrits, — 1 si erreur. 
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ANNEXE 2 
LES FONCTIONS GEM 


Les fonctions VDI 


Avant de fournir la liste exhaustive des fonctions VDI et les paramètres 
particuliers de chacune d'elles, quelques notions générales doivent être 
explicitées. 


Les fonctions VDI, utilisent, pour interagir avec le programme appe- 
lant, cinq zones d'arguments dont chaque élément est un mot (deux octets, 
soit un entier pour un microprocesseur 16 bits). Ces cinq zones sont recon- 
nues par l'éditeur de liens sous les noms de tableaux suivants : 


contrl [| : zone de contrôle de la fonction 

intin [| : zone des paramètres d'entrée 

ptsin {| : zone des coordonnées x et y de points en entrée 
intout {] : zone des paramètres de sortie 

ptsout{] : zone des coordonnées x et y de points en sortie 


Les valeurs et tailles de ces zones varient selon la fonction, exception 
faite de la zone de contrôle, dont les sept premiers éléments référent, pour 
chaque appel, au même contenu : 


Paramètres en entrée : 


contrl [0] : Numéro de la fonction. 

contrl [1] : Nombre de points en entrée. Comme chaque point nécessite deux 
coordonnées (x et y), contr! [1] est égal à la moitié du nombre 
d’arguments de ptsin. 
Mis à O si aucun argument en ptsin. 

contrl [3] : longueur du tableau intin. 
Mis à 0 si longueur nulle. 
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contrl [5] : Numéro de la sous-fonction, Nécessaire lorsque le numéro de 
fonction n’est pas suffisamment explicite. (ex. : fonction 5, fonc- 
tion 11). 


Paramètres en sortie 

contr! [2] : Nombre de points en sortie. Voir contri[1] mais relativement à 
ptsout. 

contrl [4] : Longueur du tableau intout. 


Paramètre d’entrée ou de sortie, selon la fonction 
contrl [6] : Numéro de l’identificateur VDI. 


REMARQUE GÉNÉRALE : 


la liste des fonctions VDI a été classée par thème, choix qui a paru judi- 
cieux à l’auteur au regard de son expérience de programmation. 


Pour cette raison, certaines caractéristiques communes à différents titres 
de fonction (titres qui ne doivent rien au hasard) peuvent ne pas apparaître 
et priver ainsi le lecteur de certains moyens mnémotechniques susceptibles 
de le guider. 


La nomenclature obéit aux principes suivants : 


1) Toute fonction VDI commence par la lettre v. 

2) la lettre s (pour SET) placée en seconde position indique que la fonction 
fournit un ou des paramètres au VDI. 

3) la lettre q (pour INQUIRE), elle aussi placée comme deuxième lettre, est 
utilisée dans les fonctions dont le rôle spécifique est de vous renvoyer des 
paramètres. 

4) Après un q ou un s, la troisième lettre placée avant le trait de souligne- 
ment (_) sert souvent à déterminer le rôle de la fonction : f pour FILL 
(remplissage), t pour TEXT, 1 pour LINE (ligne), m pour MARKER (mar- 
queur), etc... 


Fonctions générales 


v_opnwk fonction 1 


Ouvre une station de travail. Mêmes arguments que v_opnvwk. 
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Le VDI interdit l'ouverture de plusieurs stations de travail. Le Bureau 
GEM en ayant ouvert une lors de son chargement, cette fonction n’est guère 
utilisable que dans un bootstrap ! (cf. chapitre 3 : les interruptions). 


Pour lancer votre application du Bureau, il faut donc utiliser la fonc- 
ton v_opnvwk (voir plus loin). 


+_clswk fonction 2 


Ferme une station de travail. Utilise les mêmes arguments que v_clsvwk. 
Même remarque que ci-dessus. 


+_opnvwk fonction 100 
Ouvre une station de travail virtuelle. 


Votre application devient ainsi « propriétaire » de la station de travail 
et de l’écran et peut initialiser ses paramètres spécifiques sans qu’il y ait con- 
flit avec la station de travail ouverte par le Bureau. 


Retourne des informations système et fournit l’identificateur VDI de 
votre application. 


int id_vdi, arg:in [11], arg_out [57] ; 
v_opnvwk (arg_in, &id_vdi, arg_out) ; 


Paramètres d'appel : 

id_vdi (contrl [6l) : doit contenir en entrée (et en fait contient par défaut) 
l’identificateur de la station de travail ouverte (soit la valeur 1, identifi- 
cateur du Bureau GEM). 

Au retour, contient l’identificateur VDI de votre application. 
arg_in{0] (intin [0]) : identificateur du périphérique (1 = écran) 

arg_in{1] (intin [1]) : type de ligne 

arg_in{[2] (intin [2]) : index de couleur de ligne 

arg_in{[3] (intin [3]) : type de marqueur 

arg_in{4] (intin [4}) : index de couleur de marqueurs 

arg_in{5] (intin [5]) : police de caractères (1 = police système) 

arg_in[6| (intin [6]) : index de couleur du texte 

arg_in[7] (intin {7]) : style intérieur de remplissage 

arg_in{8] (intin [8]) : imdex de style de remplissage 

arg_in{9] (intin [9]) : index de couleur de remplissage. 

arg_in[10] (intin [10]) : système de coordonnées : par défaut, 2 système RC 
seul valide 
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Paramètres de retour : 


Est spécifié pour chaque argument la réponse (entre crochets) fournie 
par le GEM de l’'ATARI. 
arg_out{0] (intin [0]) : nombre de points adressables dans la largeur de l’écran. 
[639 en haute et moyenne résolution (+ point 0 = 640)] 
(319 en basse résolution (+ point 0 = 320)] 
arg_out{1] (intout [1]) : nombre de points adressables dans la hauteur de 
l'écran. [399 en haute résolution (+ point 0 = 400)] 
199 en basse et moyenne résolution (+ point O0 = 200)] 
arg_out{2] (intout [2]) : système permettant la réduction d’une image à 
l'échelle. [NON (= 0)] 
arg_out[3] (intout [3]) : largeur d’un pixel en microns. 
[372 en monochrome] 
arg_out{4] (intout [4]) : hauteur d’un pixel en microns. 
(372 en monochrome] 
arg_out{5] (intout [5]) : nombre de hauteur de caractères. [3]. 
arg_outfé] (intout [6]) : nombre de types de ligne. [7] 
arg_out{7] (intout [7])) : nombre d’épaisseurs de ligne. [toute épaisseur] 
arg_out[8] (intout [8]) : nombre de type de marqueurs. (5) 
arg_[9] (intout [9] : nombre de tailles de marqueurs. [8] 
arg _out{10] (intout [10]) : nombre de jeux de caractères. [1] 
arg_out{11} (intout [11]) : nombre de fonds spéciaux de remplissage. [24] 
arg_outi12] (intout [12]) : nombre de fonds hachurés de remplissage. [12] 
arg_out|13] (intout {13]) : nombre de couleurs pouvant être affichés en même 
temps à l'écran. [2 pour H.R., 4 pour M.R., 16 pour B.R.] 
arg_ out{14] (intout [14]) : nombre de formes pré-définies. [10] 
arg out{15] à arg_out{24] (soit de intout[15] à intout{24]) : 
numéro des formes supportées (voir fonctions de traçage de formes) 
arg_out{25] à arg_out{34] (soit de intout[25] à intout{34/) : 
attributs associées à chaque forme (voir fonctions traçage) 
arg_out[35] (intout [35]) : drapeau couleur 
{0 si écran mono, 1 si écran couleur] 
arg_out{36] (intout [36]) : possibilité d’inclinaison du texte. [OUI (= 1)] 
arg_out[37] (intout [37]) : possibilité de remplissage de zone. [OUI (= 1)] 
arg_out[38] (intout [38]) : possibilité de division d’un rectangle en cellules indé- 
pendantes. [NON (= 0)] | 
arg_out{39] (intout [39]) : nombre de couleurs possibles dans la palette. 
[2 si écran mono, 512 si écran couleur] 
arg_outf40] (intout [40j) : nombre de périphériques gérant la souris. [2] 
arg_out{41| (intout [41]) : périphérique gérant le curseur. [CLAVIER] 
arg_out{42] (intout [42]) : périphérique gérant les touches. [CLAVIER] 
arg_out{43] (intout [43]) : périphérique gérant les chaînes. [CLAVIER] 
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arg_out{44] (intout [44]) : type de station de travail. (ENTRÉE-SORTIE) 


: largeur minimale de caractères."[5] 

: hauteur minimale de caractères. [4] 

: largeur maximale de caractères. [7] 

: hauteur maximale de caractères. [14] 
: épaisseur minimale de ligne. [1] 

:0 

: épaisseur maximale de ligne. [40] 
:0 


arg_out{45] (ptsout [0] 
arg_out{46] (ptsout [1 
arg_out{47] (ptsout [2 
arg_out{48] (ptsout [3 
ars_out{49] (ptsout [4 
arg_out([50] (ptsout [5] 
ærg_out{51] (ptsout [6] 
arg_out|52] (ptsout [7] 
arg_out|53] (ptsout [8]) : largeur minimale d’un marqueur. [15] 

arg_out(54] (ptsout [9]) : hauteur minimale d’un marqueur. [11] 

arg_out{55] (ptsout [10]) : largeur maximale d’un marqueur [120] 
arg_out|56] (ptsout [11]) : hauteur maximale d’un marqueur. [88] 


TT TT CT 


+q_extnd fonction 102 


Retourne des informations supplémentaires, non fournies par v_opnvwk. 


int id_vdi, drapeau, arg_out [57] ; 
va extnd (id_ vdi, drapeau, arg_out) ; 


Paramètres d’appel 

id_vdi (contrl (6j) : identificateur VDI 

drapeau (intin [0]) : si O0, retourne les mêmes valeurs que v_opnwk 
: si 1, retourne les valeurs qui suivent 


Paramètres de retour 
arg_out[0] (intout [0]) : type de l’écran. 

[Moniteur graphique et alphabétique avec image commune] 
arg_out{1] (intout [1]) : nombre de couleurs de fond. 

[1 pour écran mono, 511 pour écran couleur] 
arg_out[2] (intout [2]) : effets spéciaux sur texte (CF fonctions texte) 
arg_out|3] (intout [3]) : mise à l’échelle possible. [NON (= 0) 
arg_out{4] (intout [4]) : nombre de plans. (Cf. chap. 1.1.2.) 

{1 pour H. Resolution, 2 pour M.R., 4 pour B.R.] 
arg_out{5] (intout [5]) : table de palettes modifiable. [OUI (= 0)| 
arg_out{6] (intout [6]) : vitesse de copie d’écran. 

[16A2 pixels = 1/1 000 sec] 
arg_out{7] (intout [7]) : possibilité de remplissage [OUI (= 1)} 
arg_out[8] (intout [8]) : inclinaison de caractères. [Par 90°] 
arg_out{9] (intout [9]) : nombre de modes d’écriture. [4] 
arg_out{10] (intout [10]) : mode d’interrogation des entrées. [2] 
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In + 


arg_out{11] (intout [11]) : autorise alignement de texte. [OUI (= 1)] 
arg_out|[12] (intout [12]) : encre autorisé, [NON] 

arg_out{13] (intout [13]) : {0] 

arg_out{14] (intout [14}) : longueur maximale de zone pisin. [128] 
arg_out[15] (intout [15]) : longueur maximale de zone intin. [illimité] 
arg_out{[16] (intout [16|) : nombre de boutons de souris. [2] 
arg_out{17] (intout [17]) : style pour ligne large. [NON] 

arg_out|18] (intout [18]) : mode d’écriture pour ligne large. [NON] 
arg_out{19] (intout [19]) : réservé, mis à 1. 

arg_out(20] à arg_out[44] (soit de intout{20] à intout|44]) : réservé [0] 
arg_out[45] (ptsout [0]) : coordonnée X{min) de vs_clip. 

arg_out{46] (ptsout [1]) : coordonnée Y(min) de vs_clip. 

arg_out{47] (ptsout [2}) : coordonnée X{(max) de vs_clip. 

arg_out{48] (ptsout [3]) : coordonnée Y(max) de vs clip. 

arg_out([49] à arg_out{56] (soit ptsout{4] à ptsout{11]) : réservé [0] 


v_clsvwk fonction 101 

Ferme la station de travail virtuelle ouverte par v_opnvwk. 
int id_vdi ; 
v_clsvwk (id_vdi) ; 
Paramètre d'appel : id_vdi (contr! [6] : identificateur VDI 
v_clrwk fonction 3 

Efface l’écran avec la couleur de fond d’indice 0 (blanc). 
int id_vdi ; 
v_cirwk (id_ vdi) ; 


Paramètre d’appel : id_vdi (contrl [6]) : identificateur VDI 


vs_clip fonction 129 


Cette fonction restreint l’affichage (lorsque le drapeau est à 1) à une 
zone rectangulaire spécifiée, Tout traçage à l’extérieur de ce rectangle ne sera 
pas pris en compte, . J 

L'appel de cette fonction avec le drapeau mis à O (valeur par défaut à 
l'ouverture d’une station de travail), autorise affichage global. 
int id_vdi, drap_clip, zone rec{] ; 


vs_clip (id vdi, drap _clip, zone rec) : 
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Paramètres d'appel : 


id_vdi (contri [6] : identificateur VDI 
drap_clip (intin [0]) : drapeau mis à 1 ou 0 
zone rec [0](ptsin [0]) : coord. X du coin supérieur du rectangle 
‘zone rec [1] (ptsin [1]) : coord. Y du coin supérieur du rectangle 
zone rec [2] (ptsin [2}) : coord. X du coin diagonalement opposé du rectangle. 
zone rec [3] (ptsin(3}) : coord. Y du coin diagonalement opposé du rectangle. 


vswr_mode fonction 32 


Spécifie le mode d’écriture utilisé pour tout affichage ultérieur, tant en 
ce qui concerne le traçage de ligne, le remplissage, ou l'affichage de texte 
sur écran graphique. Quatre modes sont possibles : 

1 = normal : toute nouvelle écriture est insensible au contenu de l’ancien 
écran. 


2 = transparent : sur-impression sur l’ancien écran 
3 = XOR : sur-impression en vidéo inverse sur l’ancien écran 
4 = transparent inverse : sous-impression sous l’ancien écran (cf. chap. 3.3. 


instruction A003). 
int id_vdi, mode, sel mode : 


sel mode = vswr_mode (id_vdi, mode) ; 


Paramètres d’appel : 


id vdi (contrl [6]) : identificateur vdi 
mode (intin[0]) : mode à sélectionner soit 1, 2, 3 ou 4, 
En cas de valeur invalide, le mode 1 sera sélectionné. 


Paramètre de retour : 
sel mode (intout{0]) : le mode effectivement sélectionné. 


Fonctions de tracage de lignes 


vsl_type fonction 15 


Cette fonction définit le type de ligne à utiliser pour tout traçage ulté- 
rieur, Un type est défini par un entier de seize bits, constituant le masque 
de la ligne, l'aspect final de cette ligne dépendant, bien sûr, du mode d’écri- 
ture (cf. vswr_mode). 
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Sept types de ligne sont possibles : 


. TYPE BTFEDCBA9S 76543 2 1 0 
| 1 = continu LLILILIILILILILILILIILIL 
2 = trait long 1111111111110000 
3 = point 1 1 10 0 0 0 0 1 1 1 O0 0 0 0 0 
4 = trait-point 111111100011 1 0 0 0 
5 = trait 1 11 111 1 1 0 0 0 0 O0 0 0 © 
6 = trait-point-point 111100 0 1 1 O0 0 1 1 O O O 
7 = défini par lutilisateur (Cf fonction vsl_udsty) 


int id_vdi, type, sel type ; 
sel type = vsl_type (id_vdi, type) ; 


Paramètres d'appel 


id_vdi (contrl{6l) : identificateur VDI 
type (intin{0}) : numéro du type de ligne (1 par défaut) 


| Paramètre de retour : 
| sel_type (intout{0]) : type de ligne effectivement sélectionné 


vsl_udsty fonction 113 


| 
| 
| | Permet de définir son propre type de ligne en spécifiant le masque de 
! 16 bit qui sera utilisé pour le type de ligne numéro 7 (Cf. vsl_type). 
, Le bit 0 du masque correspond au premier pixel de la ligne. 

Il est à noter que, si on utilise la couleur, certains masques dans cer- 
tains modes peuvent avoir un effet pervers (cf. chap. 3.3.). 


int id_vdi, masque ; 


vsl_udsty (id_vdi, masque) ; 


Paramètre d'appel : 
id_vdi (contr[6)) : identificateur VDI 


masque (intin{0]) : masque de ligne 
vsl_width fonction 16 


Définit l'épaisseur de ligne en pixel pour tout traçage ultérieur. La valeur 
envoyée doit être impaire, comprise entre 1 et 39. 


int id vdi, épais, sel épais ; 


sel_épais = vsl_width (id_vdi, épais) ; 
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Paramètres d'appel : 


id vdi (contrl[6)) : identificateur VDI 
épais (ptsin[0]) : épaisseur de ligne demandée 


Paramètre de retour : 
sel_épais (ptsout|0]) : épaisseur effectivement sélectionnée 


+sl_ends fonction 108 


Définit la forme de début et de fin de ligne pour tout traçage ultérieur. 
Début et fin de ligne peuvent être de styles différents, et choisis parmi les 
trois styles suivants : 


0 = carré (par défaut) 

1 =flèche 

2 =arrondi 

int id_vdi, deb ligne, fin_ligne ; 


vsl_ends (id_vdi, deb_ligne, fin ligne) ; 


Paramètres d'appel : 

id_vdi (contrl[6]) : identificateur VDI 

del_ ligne (intin{0}) : numéro du style de début de ligne 
fin_ligne, (intin{1]) : numéro du style de fin de ligne 


y_pline fonction 6 

Cette fonction trace une série de lignes (64 au maximum), en se référant 
aux points des coordonnées X et Y du tableau d’entrée, La ligne sera tracée 
en utilisant les attributs par défaut ou ceux que vous avez spécifiés. 

Le tableau d’entrée doit contenir au minimum 2 coordonnées (4 élé- 
ments) ; pour tracer un point, il suffira qu’elles soient identiques. 


int id_vdi, nb, coord_xy [2 « nb_ligne] ; 
v_pline (id_ vdi, nb, coord_xy) ; 
Paramètres d’appel : 

id_vdi (contrl{6)) : identificateur VDI 

nb (contri[1]) : nombre de lignes à tracer 


coord_xy[0] (ptsin{0]) : coord. X du premier point 
coord_xy{1] (ptsin[1]} : coord. Y du premier point 


coord_xy[2nb —2] (ptsin[2nb —2]) : coord. X du dernier point 
coord xy{2nb — 1] (ptsin{2nb — 1]) : coord. Y du dernier point 
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val_attributes fonction 35 
Cette fonction retourne les attributs qui affectent le traçage de lignes. 


int id_vdi, attrib[4] ; 
val attributes (id_vdi, attrib) ; 


Paramètre d'appel : 


id_vdi (contri[6l) : identificateur VDI 


Paramètres de retour : 

attrib[0] (intout|0]) : type de ligne (CF vsl_ type) 
attrib[1] (intout[1}) : couleur de ligne (CF vsl_color) 
attrib|2] (intout2]) : mode d’écriture (Cf vswr_mode) 
attrib|3]) intout [3]) : épaisseur de ligne (CF vsl_width) 


Fonctions de traçage de formes 


Ces fonctions permettent d’appeler des formes prédéfinies par le système, 
avec un minimum de paramètres. La plupart ayant un numéro de fonction 
identique, c’est donc le code de la sous-fonction (en contrl [5]) qui va les 
différencier. 

Les fonctions utilisant les mêmes paramètres d’appel ont été regroupées, 
en soulignant leurs quelques différences. 
vr_recfl fonction 114 
v_bar fonction 11, sous-fonction 1 
vr_box fonction 11, sous-fonction 8 
vrf_box fonction 11, sous-fonction 9 


Ces quatre fonctions dessinent un rectangle dont on spécifie les coor- 
données X et Y de deux coins opposés. 

vr_recfl dessine un rectangle sans contour. 

v_bar dessine un‘rectangle (contours possibles). 

vrf_box dessine un rectangle aux angles arrondis. 


Pour ces trois fonctions, les attributs référant au remplissage de zone 
(cf. vqf _attributes) conditionnent le traçage. 


vr_box dessine également un rectangle aux angles arrondis mais son 
traçage est conditionné par les attributs de ligne (Cf. val_attributes). 
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int id_vdi, coord_xy[4] ; 


« nom de Ia fonction » (id_vid, coord_xy) ; 


Paramètres d’appel : 

id_vdi (contrl{6]) : identificateur VDI 

coord_xy[0] (ptsin[0]) : coord. X d’un coin de rectangle 
coord_xy[1] (ptsin{1]) : coord. Y de ce même coin 

coord_xy{2] (ptsin{2]) : coord. X du coin diagonalement opposé 
coord_xy{3] (ptsin{3]) : coord. Y de ce même coin 


+_circle fonction 11, sous-fonction 4 

Dessine un disque. Les attributs de remplissage de zone affectent le tra- 
cage (cf vaf_attributes). Pour dessiner un cercle, utilisez v_arc. 
int id_vdi, x, y, rayon ; 


v_circle (id_vdi, x, y, rayon) ; 


Paramètres d'appel : 
id_vdi (contrl[6)) : identificateur VDI 
x (ptsin{0]) : coord. X du centre du cercle 


y (ptsin|[1]) : coord. Y du centre du cercle 
rayon (ptsin[4]) : taille du rayon en pixels 


Y_arc fonction 11, sous-fonction 2 
v_pieslice fonction 11, sous-fonction 3 


La fonction v_arc dessine un arc de cercle dont on spécifie le centre, 
le rayon, ainsi que les points de départ et d’arrivée. Les attributs de ligne 
conditionnent son traçage (cf. vaf_attributes). 

La fonction v_pieslice dessine une portion de disque, avec des para- 
mètres d’appel identiques, Ici cependant, ce sont les attributs de remplissage 
qui conditionnent le traçage (Cf vaf_attributes). 


Pour ces deux fonctions, la même remarque générale s'impose : 
Un angle se donne en dixième de degré en considé- 

rant la valeur 0 comme le point horizontal droit 

et en incrémentant dans le sens inverse des aiguil- 

les d’une montre. 
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int id_ vdi, x, y, rayon, debut, fin ; 


v_arc (id_vdi, x, y, rayon, debut, fin) ; 
v_pieslice (id_vdi, x, y, rayon, debut, fin) ; 


Paramètres d’appel : 
id_vdi (contrl{6]) : identificateur VDI 
x (ptsin{0]) : coord. X du centre de l’arc ou portion de cercle 
y (ptsin[1]) : coord. Y du centre de l'arc ou portion de cercle 
rayon (ptsin[6]) : rayon en pixels 

! debut (intin{0]) : départ de l'angle (compris entre 0 et 3600) 
fin (intin{1]) : fin de l’angle (compris entre 0 et 3600) 


_ellipse fonction 11, sous-fonction 5 
v_ellare fonction 11, sous-fonction 6 
v_ellpie fonction 11, sous-fonction 7 
La fonction v_ellipse dessine une ellipse. 
La fonction v_ellpie dessine une portion d’ellipse. 


Ces deux fonctions sont affectées par les attributs de zone de remplis- 
sage (cf. vaf_attributes) 


La fonction v_ellarc dessine un arc elliptique, elle est affectée par les 
attributs de traçage de ligne (cf. val_attributes). 


En ce qui concerne les paramètres d’angles pour v_ellarc et v_ellpie, voir 
la description dans la fonction précédente. » » 
int id_vdi, x, y, xraÿon, yrayon ; 
int debut, fin ; /* pour v_ellarc et v_ellpie */ 


v_ellipse (id_vdi, x, y, XTAyOn, yrayon) ; 
v_ellarc (id_vdi, x, y, xrayon, yrayon, debut, fin) ; 
v_ellpie (id_vdi, x, y, xrayon, ÿrayon, debut, fin) ; 
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u#r. 


Paramètres d’appel : 

id_vdi (contrl|6]) : identificateur VDI 

x (ptsin|[0]) : coord. X du centre de l’arc (ou ellipse) 

y (ptsin[1}) : coord. Y du centre de l’arc (ou ellipse) 

xrayon (ptsin(2]) : rayon vertical en pixel 

yrayon (ptsin|3]) : rayon horizontal en pixel 

debut (intin{0}): départ de l’angle en dixième de degré (0 à 3600) 
fin (intin{[1]) : fin de l’angle en dixième de degré (0 à 3600) 


Fonctions de remplissage de forme 


vsf_interior fonction 23 


Sélectionne le type de remplissage à utiliser pour tout remplissage ulté- 
rieur. Cinq types sont possibles : 


fond vide couleur du fond de l'écran (par défaut) 
fond plein couleur définie par vsf_color 

fond à motifs (cf vsf_style) 

fond hachuré (cf vsf_style) 

= fond défini par l’utilisateur (cf vsf_udpat) 


Ci 


0 
1 
2 
3 
4 


int id_vdi, type remp, sel_remp ; 


sel remp = vsf_interior (id_vdi, type remp) ; 


Paramètres d’appel : 


id_vdi (contrl{6]) ; identificateur VDI 
type_remp (intin[0]) : numéro du type requis 


Paramètre de retour 
sel_ remp (intout{0]) : type effectivement sélectionné 


vsf_style fonction 24 


Sélectionne une matrice qui définit le style-de remplissage. Cette fonc- 
tion n’est utilisable que pour les types de remplissage 2 et 3. 
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EL à 


Avec le type de remplissage numéro 2 {motif} 


La couleur des matrices est définie par vsf_color. 


int id_vdi, style remp, sel _style; 


sel style = vsf_style(id vdi, style_remp); 


Paramètres d’appel 


id_vdi (contrl[6]) : identificateur VDI 
style remp (intin[0]) : numéro de style requis 


Paramètre de retour 
sel_style (intout|0]) : style effectivement sélectionné 
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vs£_udpat fonction 112 


Permet de créer un fond défini par l’utilisateur, appelable en sélection- 
nant le type de remplissage numéro 4 (cf vsf_interior). 

Le masque de la matrice est spécifié dans 16 mots avec le bit 15 du pre- 
mier mot représentant le bit du coin supérieur gauche, et le bit 0 du dernier 
mot représentant le bit du coin inférieur droit, 

La basse et moyenne résolution utilise différents plans de masque pour 
définir la matrice (cf. chap. 3.3. instruction A004). 


int id_vdi, plan, def_fond [16 + plan] ; 
vsf_udpat (id_vdi, def fond, plan) ; 


Paramètres d'appel 

id_vdi (contr1 [6]) : identificateur VDI 

plan (contri[3]/16) : nombre de plans 

def_fond[0] (intin[0|) : premier mot de définition matrice 


def_fond[15] (intin[15]) : dernier mot du premier plan 


Si plusieurs plans, alors. 
def_fond{16] (intin[16)) : premier mot du deuxième plan 


def_fond[16xplan — 1] Gntin[16«plan —1]) : dernier mot du dernier plan 


Ysf_perimeter fonction 104 


Indique au VDI si, lors d’un remplissage, une zone doit ou non être entou- 
rée d’une ligne de contour. Ligne invisible, puisqu'elle est de la couleur du 
remplissage ! 


int id vdi, peri drap, sel perds 


sel _peri = vsf perimeter (id_vdi, peri_drap)}; 


Paramètre d'appel : 


id_vdi (contrl[6]) : identificateur VDI 
peri_drap (intin{0]) : drapeau de périmètre de zone 
0 = périmètre invisible, sinon = visible 


Paramètre de retour : 
sel_peri (intout{0}) : drapeau effectivement sélectionné 
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v_fillarea fonction 9 


Cette fonction colorie un polygone quelconque délimité par des points 
(64 au maximum), le dernier de ceux-ci rejoignant le premier pour clore la 
surface à remplir (voir 3.3. instruction AO0F). 

Utilise les attributs de remplissage (cf vaf_attributes). 


int id vdi, nb.point, coord. xy C2 * nb_pointi; 


v_fillareatid_vdi, nb_point, covrd_xy)3 


id vdi (contrl[6]) : identificateur VDI 

nb_point (contri[1]) : nombre de points du polygone 
coord_xy{0] (ptsin{0]) : coord. X du premier point 
coord_xy{1] (ptsin{1]) : coord. Y du premier point 


et en considérant un polygone à N points, 


coord_xy[2N —2] (ptsin[2N —2]) : coord. X du dernier point 
coord_xy[2N—1} (ptsin[2N — 1]) : coord. Y du dernier point 


v_contourfill fonction 103 

Remplit, à partir d’un point précisé, une surface délimitée soit par le 
bord de l'écran, soit par les pixels de la couleur d’index spécifié. Si ce dernier 
a une valeur négative, tout pixel d’une couleur différente de la zone à rem- 
plir constitue une « barrière » (cf. chap. 3.3. instruction A00F). 


int id_vdi, X3 Yr index; 


v_contourfilltid_vdi, %, y, index); 


Paramètres d'appel : 


id_vdi (contri[6]) : identificateur VDI 

x (ptsin{0]) : coord. X du point de départ de remplissage 
y (ptsin{[1]) : coord. Y du point de départ du remplissage 
index (intin[0}) : numéro de la couleur de clôture 


vaf_attributes fonction 37 


Cette fonction retourne les attributs qui affectent tout remplissage de 
zone, 
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int id vdi, attrib [4]; 


Ints vafattrtibutest id_vdi, attrib}s | 
e la l 


Paramètre d'appel fa 
id_vdi (contrl[6]) : identificateur VDI 


Paramètres de retour : . 
attrib{0] (intout|0]) : type de remplissage (cf vsf_interior) l 
attrib{1] (intout{1]) : couleur de remplissage (cf vsf_ color) 
attrib[2} (intout|2]) : style de remplissage (cf vsf_style) Û 
attrib[3] (intout{3]) : mode d'écriture (cf vswr_mode) 


Fonctions de marqueurs 


Les marqueurs sont des formes pré-définies, de taille restreinte, suscep- 
tibles d’être utilisés pour agrémenter le graphisme. 


vsm_type fonction 18 


Sélectionne le type de marqueurs pour tout affichage ultérieur. Six types , 
sont possibles : Î 
un point. 
le signe plus ll: 
Pastérisque 
le carré 
la croix 
le losange 


EREUNUTU 


D LU R Ww ND = 
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int id_vdi, type_mar, sel mar; h 


sel _mar = vsn_typetid_vdi, type_mar) 3 


Paramètres d'appel : 


id_vdi (contrl[6)) : identificateur VDI 
type_mar (intin|0]) : type de marqueur requis 


Paramètre de retour : 
sel_mar (intout{0|) : type effectivement sélectionné 
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vsm_height fonction 19 


Sélectionne la hauteur du marqueur (sauf le point, qui ne peut être modi- 
fié), parmi 8 tailles comprises entre 11 et 88 pixels. Le VDI retourne la plus 
proche (et inférieure) taille valide. La largeur est modifiée en proportion. 


int id_vdi, haut_mar, sel_hoar; 


sel _hnar = Vsm_height{id_ vdi, haut mar); 


Paramètres d’appel 


id_vdi (contrl[6]) : identificateur VDI 
haut _ mar (ptsin[1}) : hauteur requise du marqueur en pixels 


Paramètre de retour : 
sel_hmar (ptsout{1}) : hauteur effectivement sélectionnée 


v_pmarker fonction 7 


Dessine un ou des marqueurs aux coordonnées spécifiées, selon les attri- 
buts définis (cf. vqam_attributes). 


int id vdi, nb, coord_xy[Z # nb mar]; 


v_pmarkertid vdi, nb, coord.xy); 


Paramètre d’appel : 

id_vdi (contri[6]) : identificateur VDI 

nb (contrl[1}) : nombre de marqueurs à tracer 
coord_xy[0] (ptsin[0]) : coord. X du premier marqueur 
coord_xy{1] (ptsin|1]) : coord. Y du premier marqueur 


coord_xy{2nb —2](ptsin[2nb —2]) : coord. X du dernier marqueur 
coord_xy{2nb — 1] (ptsin[2nb — 1]) : coord. Y du dernier marqueur 


vqm_attributes fonction 36 
Retourne les attributs qui affectent le traçage des marqueurs. 


int id_vdi, attribl4]; 


vam_attributesQid_vdi, attrib); 


166 


VS 


Paramètre d'appel : 
id_vdi (contrl[6]) : identificateur VDI 


Paramètres de retour : 

attrib[0] (intout[0]) : type du marqueur (cf vsm_type) 
attrib[1] (intout{1]) : couleur du marqueur (cf vsm_color) ) 
attrib|2] (intout{2]) : mode d’écriture (cf vswr_ mode) 1! 
attrib{3] (ptsout|1]) : hauteur du marqueur (cf vsm_height) “| 


Fonctions de couleurs | 


vs_color fonction 14 


Cette fonction permet d’associer un numéro d’index avec un pourcen- ! 
tage de Rouge, Vert, Bleu, créant ainsi une palette utilisateur (cf. chap. 1.1.2, | 
relatif au système graphique). 

Les seize index permis prennent les valeurs de 0 à 15, l’index O étant 
considéré par le système comme la couleur de fond. 

L’intensité des couleurs est définie par une valeur comprise entre 0 et 
1 000, mais la valeur donnée sera arrondie par ia fonction pour l'adapter 
à une codage sur 3 bits. Tout écart de l’éventail de valeurs autorisées entraîne : 
un réajustement aux valeurs extrêmes (0 si < 0, 1 000 si > 1 000). ‘ 


int id_vdi, index, rgb_in[33; 


vs.color (id vdi, index, rgb_in)3 


Paramètres d'appel : 


id_vdi (contri[6])) : identificateur VDI 
index (intin{0]) : numéro d’index 
rgb_in[0] (intin{(1]) : pourcentage de rouge (entre 0 et 1 000) 
rgb_in[1} (intin[2)) : pourcentage de vert , 
reb_in{2] (intin{3]) : pourcentage de bleu ! 


vsl_color fonction 17. (ligne) 
vsf_color fonction 25. (remplissage) | 
vsm_color fonction 20. (marqueurs) 
vst_color fonction 22. (texte) 
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Ces quatre fonctions sélectionnent l'index de couleur qui sera utilisé par 
le type de fonction précisé entre parenthèse. 
La couleur par défaut est celle d’indice 1. 


int id vdi, ind_coul, sel_coul; 


sel_coul = "nom de la fonction" (id vdi, ind-coul); 


Paramètres d’appel : 


id_vdi (contrl[6)) : identificateur VDI 
ind_coul (intin|0]) : index de la couleur (cf. vs_color) 


Paramètre de retour : 
sel_coul (intout|0]) : index effectivement sélectionné 


v_get_pixel fonction 105 


Retourne la valeur et index de la couleur d’un pixel spécifié. Voir chap. 
1.1.2. pour la correspondance entre couleur et index. 


int id_vdi, x, y, *val.col, *index] 


vget_pixeltid vdi, 4, Ys val_col, index); 


Paramètres d'appel : 


id_vdi (contrl(6|) : identificateur VDI 
x (ptsin(0}) : coord. X du pixel 
y (ptsin{1}) : coord. Y du pixel 


Paramètres de retour : 


val_col (intout{0]) : valeur de la couleur 
index (intout{[1]) : index de la couleur 


va_color fonction 26 


Cette fonction retourne soit la valeur RVB requise (lors d’un vs_color) 
d’un index de couleur, soit la valeur arrondie réellement placée par le système 
pour ce même index, Le choix de la valeur à recevoir est fonction de l’état 
du drapeau. 


int id_vdi, index coul, drapeau, rob £51; 


va_color(id_vdi, index _coul, drapeau, rgb}; 
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Paramètres d'appel : 
id_vdi (contrl[6])) : identificateur VDI 
index_coul (intin{0]) : index de la couleur 
drapeau (intin{1]) : si mis à 0 retourne la valeur requise 
si mis à 1 retourne la valeur réelle arrondie 


Paramètres de retour 

coul (intout{0]) : index de couleur 

r8b[0] (intout{1]) : pourcentage de rouge dans la couleur 
rgb[1] (intout{2]) : pourcentage de vert dans la couleur 
reb|2] (intout|3]) : pourcentage de bleu dans la couleur 


Affichage de texte en mode graphique 


Le mode graphique est le mode par défaut lors de l’ouverture d’une sta- 
tion de travail. Tout affichage dans ce mode réfère à la position du curseur 
graphique. 


vst_alignment fonction 39 


Cette fonction définit le type d’alignement (horizontal et vertical) que 
le VDI utilisera lorsque lui sera demandé un affichage de texte à la position 
du curseur graphique. 


ligne haute 
ligne supérieure 
demi-tigne 


ligne de base 
ligne inférieure 
ligne basse 


Par défaut, c’est l'alignement horizontal à gauche et l’alignement verti- 
cal sur la ligne de base qui sont sélectionnés. 


int id_vdi, hor_in, vert_in, hor_out, vert_out ; 


vst_alignment (id_vdi, hor_in, vert_in, &hor_out, &vert out) : 
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Paramètres d’appel : 


id_vdi (contrl[6}) : identificateur VDI 
hor_in (intin{0]) : alignement horizontal requis (3 valeurs possibles) 


0 = affichage à la gauche du curseur 
1 = affichage centré sur le curseur 
2 = affichage à la droite du curseur 


vert_in (intin(1]) : alignement vertical requis (S valeurs possibles) 

0 = la coord. Y du curseur correspond à la « ligne de base » 
la coord. Ÿ du curseur correspond à la « demi-ligne » 
la coord. Ÿ du curseur correspond à la « ligne supérieure » 
la coord. Ÿ du curseur correspond à la « ligne basse » 
la coord. Y du curseur correspond à la « ligne inférieure » 
la coord. Ÿ du curseur correspond à la « ligne haute » 


ll 


Il 


CENTRES 
(l 


Paramètres de retour : 


hor_out (intout{0]) : alignement horizontal sélectionné 
vert_out (intout[1]) : alignement vertical sélectionné 


vst_height fonction 12 


Cette fonction spécifie la hauteur des caractères, en fait la distance entre 
la ligne de base et la ligne haute (voir schéma ci-dessus). 

Le VDI ajustera la hauteur demandée au plus proche de ses hauteurs 
et déterminera la largeur du caractère en proportion. 

La hauteur minimale est de 4 pixels. 


int id_vdi, haut car, car_larg, car.haut, cel larg, cel_haut; 


vst_hetght Gid.vdi, haut_car, Wear_larg, &car haut, 
&cel larg, &cel_ haut); 


Paramètres d'appel : 


id_vdi (contri[6)) : identificateur VDI 
haut_car (ptsin[1]) : hauteur de caractère requise 


Paramètres de retour 


car_larg (ptsout[0]) : largeur de caractère sélectionnée 
car_haut (ptsout{1]) : hauteur de caractère sélectionnée 
cel larg (ptsout{2])  : largeur de cellule sélectionnée 
cel_haut (ptsout[3]) : hauteur de cellule sélectionnée 
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st_rotation fonction 13 
Spécifie l’angle de rotation de la ligne de base du caractère. Les 4 valeurs 


permises sont, en dixième de degré : 0, 900, 1 800, 2 700. 
int sel_base, id_vdi, angle; 


sel_base = vet rotation (id_vdi, angle); 


Paramètre d'appel : 


id_vdi (contrl(6]) : identificateur VDI 
angle (intin{0]) : l'angle de rotation en dixièmes de degré 


Paramètre de retour : 
sel_base (intout{0]) : l’angle effectivement sélectionné 


vst_effects fonction 106 


Cette fonction permet de spécifier un ou plusieurs effets spéciaux sur 
les caractères. Ces effets sont sélectionnés si le bit leur correspondant est mis 


bit 0 = caractère épaissi 

bit 1 = caractère à intensité réduite 
bit 2 = caractère oblique 

bit 3 = caractère souligné 

bit 4 = caractère esquissé 


Exemple : la valeur $B (1011 en binaire) dans « effet » spécifiera un 
caractère épaissi, à intensité réduite, et souligné. 


int id.vdi, sel _effet, effet; 


sel effet = vst effects (id_vdi, effet)s 


Paramètres d'appel : 


id_vdi (contri[6]) : identificateur VDI 
effet (intin{0]) : valeur de l’effet 


Paramètre de retour : 
sel_effet (intout{0]) : effets sélectionnés 
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v_gtext fonction 8 

Cette fonction affiche un ou plusieurs caractères sur l’écran graphique, 
à la position spécifiée par ses coordonnées. L'affichage est conditionné par 
les différents attributs de texte (cf. vat_attributes). 


Les codes ASCII de la chaîne à afficher sont stockés dans les octets fai- 
bles du tableau d’entrée « intin ». 


int id_vdi, xs V3 
char chaine En + 1]; Jkn = nonbre de caractères de La chaine */ 
vegtent (id vdi, #3; Vs chaine); 


Paramètres d’appel : 

id_vdi (contrl[6]) : identificateur VDI 

x (ptsin{0]) : coord. X du point d’affichage 

y (ptsin![1}) : coord. Y du point d'affichage 
chaîne[0] (intin{0}) : premier caractère de la chaîne 


chaîne{n] (intin{n]) : valeur O indiquant la fin de chaîne 


v_justified fonction 11, sous-fonction 10 


Affiche une chaîne de caractères à l’écran en tentant, selon les facultés 
qui lui sont laissées, de la justifier à gauche et à droite. Notez que cette fonc- 
tion s'utilise avec un code de sous-fonction en contrl [5]. ‘ 

Les attributs de texte conditionne l’affichage (cf. vat_attributes). 


int idevdi, x Y, dong, aut.mot, aut,carac 
char chaine En + 13; /X n = longueur de chaine */ 


vusustified (idvdis 9 Ys chaine, long, aut mot, aut,carac); 


Paramètres d’appel : 

id_vdi (contrl[6]) : identificateur VDI 

x (ptsin[0}) : coord. X du point d’affichage 

y (ptsin{1|) : coord. Y du point d'affichage 

long (ptsin|2}) : longueur, en pixels, laissée pour l'affichage 

aut_mot (intin[0]) : sinon-zéro, autorise le VDI à modifier l’espacement entre 
les mots, Si 0, alors interdiction 

aut_carac (intin[1|) : si non-zéro, autorise le VDI à modifier l’espacement 
entre les caractères. Si 0, alors interdiction 


172 


chaîne[0] (intin{2]) : premier caractère de la chaîne 
chaîne[n] (intin{n +2]) : valeur 0 indiquant la fin de chaîne 


vat_extent fonction 116 


Cette fonction retourne les coordonnées d’un rectangle représentant 
l'encadrement de la chaîne spécifiée, Tracer des lignes entre ces points per- 
met donc d’entourer la chaîne de caractère. 


Les quatre points retournés ont des coordonnées relatives à la chaîne 
et ne tiennent donc pas compte de la position de celle-ci sur l'écran. 


Le point 1 indique le coin inférieur gauche du rectangle, 
Le point 2 indique le coin inférieur droit, 

Le point 3 indique le coin supérieur droit, 

Le point 4 indique le coin supérieur gauche. 


int id vdi, rect CB]; 
char chaîne En + 11; /*X n = nombre de caractères de la chaine */ 


vat.extent (id_vdi, chaine, rect)}; 


Paramètres d'appel : 


id_vdi (contrl[6]) : identificateur VDI 
chaîne|0] (intin{0]) : premier caractère de la chaîne 


chaîne/[n| Gintin{n]) : valeur 0 indiquant la fin de la chaîne 


Paramètres de retour : 


rect{0] (ptsout{0]) : coord. relative X du point 1 
rect{1] (ptsout{1|) : coord. relative Y du point 1 


rect{6] (ptsout|6}) : coord. relative X du point 4 
rect{7] (ptsout|7]) : coord. relative Y du point 4 


vat_width fonction 117 : 


Retourne la largeur, en pixels, de la cellule et des demi-espacements gau- 
che et droit, (cf. schéma dans vst_alignment) d’un caractère spécifié. 

La fonction ne tient pas compte de l'influence éventuelle des effets spé- 
ciaux sur les largeurs retournées. 
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int id_vdi, cel larg, gau_esp, droit_esp, erreur; 
char carac; 


erreur = vak width (id vdi, carac, &cel larg, &gau_esp, 
&droit_esp}; 


Paramètres d’appel : 


id_vdi (contri[6)) : identificateur VDI 
carac (intin[0]) : code ASCII du caractère 


Paramètres de retour : 


erreur (intout{0]) : —1 si caractère non valide sinon, code ASCII du carac- 
tère requis 

cel_ larg (ptsout|0]) : largeur de la cellule 

gau_esp (ptsout[2}) : demi-espacement gauche 

droit_esp (ptsout{4]) : demi-espacement droit 


vat_attributes fonction 38 


Cette fonction retourne les attributs courants qui affectent l’affichage 
du texte graphique. 


int id vdi, attrib (101; 


vatattributes (id vdi, attrib); 


Paramètre d'appel 
id_vdi (contri[6]) : identificateur VDI 


Paramètres de retour 


attrib{0] (intout|0]) : police de caractères (cf vst load_fonts) 
attrib[1] (intout[1}) : couleur du texte (cf vst_color) 

attrib[2] (intout{2]) : angle d’inclinaison du texte (cf vst_rotation) 
attrib[3] (intout{3]) : alignement horizontal (ef vst_aligenment 
attrib{4] (intout{4|) : alignement vertical (cf. vst_alignment) 
attrib[5] (intout{5]) : mode d’écriture (cf. vswr_mode) 

attrib|6] (ptsout[0]) : largeur des caractères 

attrib|7] (ptsout{1]) : hauteur des caractères 

attrib[8] (ptsout{2]) : largeur de la cellule de caractère 

attrib[9] (ptsout|3]) : hauteur de la cellule de caractère 
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Fonctions texte en mode alphanumérique 


Le VDI dispose d’un véritable éditeur (celui dont se sert d’ailleurs l’acces- 
soire de bureau « VT.52 »), riche d’un grand nombre de commandes inter- 
nes dont voici les principales : 


1) Les caractères de commandes compris entre $07 et $0D (correspondant 
à l'appui simultané de la touche « CONTROL » et, respectivement, des tou- 
ches « G » à « M ») sont valides. 


Ex : CONTROL-J (c’est-à-dire $0A) provoque le passage du curseur à 
la ligne suivante. 


2) Les différents caractères précédés de l’appui de la touche «&ESCAPE » ont 
les fonctions suivantes : 


À : curseur vers le haut. B : curseur vers le bas. 

C : curseur vers la droite. D : curseur vers la gauche. 

E : CLEAR-HOME F : HOME 

d : efface curseur — haut écran. J : efface curseur — fin écran. 
K : efface curseur —+ fin ligne. o : efface début ligne — curseur. 
M : efface ligne. L : insert de ligne. 

e : activation curseur f : désactivation curseur. 

p : vidéo inverse, q : vidéo normale, 


v : autorise le retour de ligne automatique. 
w : interdit le retour de ligne automatique. 
j : « marque » la position du curseur. 
k : positionne le curseur à la « marque » de ESC-i. 
b (+ 1 paramètre) : quartet faible du paramètre = couleur du caractère, 
c:(+ 1 paramètre) : quartet faible du paramètre = couleur de cellule, 
y : (+ 2 paramètres) : envoie le curseur à la position absolue spécifiée par 
la valeur des paramètres moins $20. 

Ex : ESC-Y # 0 (respectivement $23, $30) positionne le curseur à la troisième 

rangée, dixième colonne. 


Les fonctions suivantes s’adressent directement à l’éditeur VDI. Elles 
utilisent toutes le numéro de fonction 5 (appelée ESCAPE par le GEM), et 
s’identifient donc par le numéro de sous-fonction. 


v_enter_cur fonction 5, sous-fonction 3 


Cette fonction génère l'entrée dans l'éditeur, provoque l’activation du 
curseur alpha dans le coin supérieur de l’écran, désactive le mode graphique. 
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int id _vdis 


v_enter_cur tid_vdi); 


Paramètre d'appel : 
id_vdi (contrl[6)) : identificateur VDI 


Y_Ccurup fonction 5, sous-fonction 4 
y_eurdown fonction 5, sous-fonction 5 
y_curright fonction 5, sous-fonction 6 
v_curleft fonction 5, sous-fonction 7 
v_curhome fonction 5, sous-fonction 8 


Ces 5 fonctions provoquent un déplacement du curseur alphanumérique, 
à la rangée supérieure pour v_curup 
à la rangée inférieure pour v_curdown 
une colonne à droite pour v_curright 
une colonne à gauche pour v_curleft 
à sa position initiale pour v_curhome (coin haut à gauche) 


int id_vdi; 


“nom de la fonction" Gd_vdi); 


Paramètre d'appel : id_vdi (contri[6)) : identificateur VDI 


v_rvon fonction 5, sous-fonction 13 
v_rvoff fonction 5, sous-fonction 14 


v_rvon affiche tout texte ultérieur en vidéo inverse, v_rvoff annule l'effet 
précédent. 


int id_vdi ; 
« Nom de la fonction » (id_vdi) ; 
Paramètre d'appel : id_vdi (contrl[6|) : identificateur VDI 


v_eeos fonction 5, sous fonction 9 
v_eeol fonction 5, sous-fonction 10 


La fonction v_eeos efface depuis curseur alpha jusqu’à fin d’écran. 
La fonction v_eeol efface depuis curseur alpha jusqu’à fin de ligne. 


int id.vdi; 


"nan de la function" {id_vdi); 
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“Paramètre d'appel : id_vdi (contrl[6]) : identificateur VDI 


vs_curaddress fonction 5, sous-fonction 11 
Déplace le curseur alpha à la position spécifiée. 


int id_vdi, rangée, colonne; 


vs.curaddress (Îid_vdi, rangee, colonne): 


Paramètres d'appel : 

id_vdi (contri[6]) : identificateur VDI 

rangee (intin[0|) : numéro de la rangée (1 minimum) 
colonne (intin|[1]) : numéro de la colonne (1 minimum) 


v_curtex fonction 5, sous-fonction 12 


Affiche une chaîne de caractères à la position du curseur alpha. 


int id vdi ; 
char chaîne [n + 1]; /«n = longueur de chaîne */ 
v_curtext (id vdi, chaîne) ; 


Paramètres d'appel : 


id_vdi (contrl{6)) : identificateur VDI 
chaînel0] (intin{0}) : premier caractère de la chaîne 


chaîne{n] (intin[n}) : valeur 0 terminant la chaîne 


vq_curaddress fonction 5, sous-fonction 15 
Retourne la position du curseur alpha. 


int id_vdi, rangée, colonne; 


.Va.curaddress Cid_vdi, rangée, &colonne); 


Paramètre d’appel : 
id_vdi (contri[6]) : identificateur VDI 


Paramètres de retour : 
rangee (intout{0]) : numéro de rangée 
colonne (intout{1]) : numéro de colonne 
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va _chcells fonction 5, sous-fonction 1 

Retourne le nombre de positions, en rangées et en colonnes, auxquelles 
le curseur alpha peut se placer. La réponse dépend de la taille de la cellule 
de caractère utilisée. 


int id vdi, rangée, colonne; 


va_chcells (id_vdi, krangée, &colonne); 


Paramètre d'appel : 
id_vdi (contrl[6}) : identificateur VDI 


Paramètres de retour : 


rangee (intout{0]) : nombre de rangées adressables 
colonne (intout{[1]) : nombre de colonnes adressables 


ESCAPE 101 
Utilisable uniquement en assembleur : décale le curseur ALPHA en raul- 
tipliant le nombre de caractères par ligne, par l’argument ris en intin{0]. 


ESCAPE 102 | 
Initialise une police de caractères utilisable par l'éditeur VDI. 


Cette fonction n’a pas de nom reconnu par l'éditeur de liens et ne peut 
donc être appelée en C. Dans le chapitre 3.1.3. est listée la routine assem- 
bleur permettant d’accéder à cette fonction. 


v_exit_eur fonction 5, sous-fonction 2 
Sortie de l’éditeur VDI et réactivation du mode graphique 


int id_vdis 


vetit eur tid vdi); 


Paramètre d'appel : id_vdi (contrl{6l) : identificateur VDI 
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Fonctions formes souris 


vse_form fonction 111 

Permet de redéfinir la forme de la souris en spécifiant bits de données 
et de masques, et point-souris (c. chap. 3.3. instr. AO0B). 

Pour données et masque, le bit 15 du premier mot correspond au coin 
supérieur gauche de la forme. Le point-souris indique le point de la forme 
devant être considéré comme coordonnées X et Y de la souris (se donne rela- 
tivement au coin supérieur gauche de la forme). : 


int id vdi, sour for C37]; 


vsc form (id.vdi, sour for); 


Paramètres d’appel : 

id_vdi (contri[6]) : identificateur VDI 
sour_for[0] (intin{0]) : coord. X du point-souris. 
sour_for[1] (intin[1]) : coord. Y du point-souris. l 
sour_for|2] (intin[2]) : réservé, doit être à 1. 
sour_for[3] (intin[3]) : index couleur du masque (en théorie à 0). ! 
sour_for(4] (intin4]) : index couleur données (en théorie à 1). 
sour_for[5] à [20] (intin[5] à [20]) : mots du masque. 
sour_for(21] à [36] (intin[21] à [36]) : mots des données. 


v_hide_c fonction 123 


Cache la souris et décrémente un compteur (cf. chap. 3.3. instructions 
A009 et AO0A). 


int id_vdi; 


vhide ce tid_vdi); 


Paramètre d’appel : id_vdi (contrl[6]) : identif. VDI. 


v_show_c fonction 122 


Fait apparaître la souris si compteur = 0, ou s’il est spécifié de ne pas 
tenir compte de ce compteur (cf. chap. 3.3. instructions A009, AO0A). 


int id vdi, dp cpt; 


v_shou_c (id vdi, dp.cpt); 
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Paramètres d'appel : 
id_vdi (contrl[6]) : identificateur VDI. 
dp_cpt (intin[0]) : si 0, ne se soucie pas du compteur. 


v_dspcur fonction 5, sous-fonction 18 
Visualise la souris aux coordonnées spécifiées. 
int id_vdi, #, ys 


v_dspeur (id.vdi, #3 y); 


Paramètres d’appel : 
id_vdi (contrl[6]) : identificateur VDI. 


x (ptsin[0}) : coord. X du point d’affichage. 
y (ptsin[1]) : coord. Y du point d'affichage. 


y_rmeur fonction 5, sous-fonction 19 
Supprime la dernière souris affichée. 
int id_vdi; 


vrmeur (id vdi); 


Paramètre d’appel : id _vdi (contrl [6)) : identificateur VDI. 


Fonctions d'entrées souris et clavier 


Le VDI permet d'interroger les périphériques souris et clavier en utili- 
sant deux « modes d’interrogations » différents : 


— Je mode « attente » (request) qui ne revient de la fonction que lorsqu’une 
entrée a effectivement eu lieu. 

— le mode « test » (sample) qui interroge le périphérique et retourne, sans 
attendre, l’état de celui-ci. 


Dans quatre « genres d’entrée » que le GEM peut implémenter, seuls 
deux sont disponibles dans la version 520 ST : 


— « locator » qui, s’adressant à la souris, retourne une localisation. 
— «string » qui retourne une chaîne du clavier. 
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Le genre « valuator » (qui gère uniquement les touches de direction- 
clavier) n’est pas implémenté, « choice » qui permet de spécifier une alter- 
native retourne toujours la valeur 1 et n’est donc pas utilisable. 


vsin_mode fonction 33 
Permet de spécifier le mode d’interrogation requis pour un genre d’entrée 
donné, 


int id_vdi, genre, mode; 


vsin_mode (id vdi, genre, mode); 


Paramètres d'appel : 

id_vdi (contrl[6|) : identificateur VDI 

genre (intin{0]) : 1 (« locator » : souris), 4 (« string » : clavier) 
mode (intin[1]) : si 1 = « attente », si 2 = « test ». 


vrq_locator (ou vsm_locator) fonction 28 
Interroge la souris selon le mode défini par vsin_mode. Les touches de 


direction du clavier (qui permettent également le déplacement de la souris) 
sont testées. En mode « attente », la souris est affichée. 


int id vdi, état, x, y, xout, yout, rep} 


etat = vratsm) locator (id_vdi, x, y, tout, &yout, &rep)3; 


Paramètres d'appel : 
id_vdi (contri[é]) : identificateur VDI. 


x (ptsin{0]) : coord. X initiale de la souris 
y (ptsin{1]) : coord. Y initiale de la souris 


Paramètres de retour : 


état (contr{2] | contrl[4]< <1) : à 0 (mode « test ») si aucun déplacement, 
à 1 si déplacement souris, à 2 si bouton pressé, à 3 si (1 + 2). 

xout (ptsout{0)) : nouvelle coord. X de la souris. 

yout (ptsout{[1]) : nouvelle coord. Y de la souris, 

rep (intout{0]) : si bouton, valeur bouton (cf. vq_ mouse) + $20 
Si touche clavier, ASCII dans l’octet faible, code de la touche 
(cf TRAP 1, fonction 1) dans l’octet fort. 
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vrqa_ string (vsm_string) fonction 31 

Retourne une chaîne du clavier selon le mode défini par vsin_mode. 

En mode « attente », les caractéristiques entrés au clavier sont stockés 
tant que le tampon spécifié n’est pas plein ou que la touche RETURN n’est 
pas pressée, 

En mode « test », c’est le tampon-clavier du système qui est lu et son 
contenu renvoyé, avec les mêmes arrêtoirs que pour le mode « attente ». 


int etat, id_vdi, max_lg, dp ec, xy_ec [2]; 
char chaine CNI; 


etat = vra(sm)_string Cid vdi, max_1g, dp.ec, xy.ec, chaine); 


Paramètres d’appel : 


id_vdi (contr[6)) : identificateur VDI 

max_Ig (intin{0}) : longueur de chaîne requise (si valeur < 0, la longueur de 
Chaîne maximum = longueur du tableau de sortie intout|]). 

xy_ec{0] (ptsin[0l) : coord. X de l’affichage de l’écho. 

xy_ec{1] (ptsin[1]) : coord. Y de affichage de l'écho. 


Paramètres de retour : 
chaînelO] à chaîne[N — 1] (intout{0] à intout [N—1] : 
code ASCII de la chaîne reçue (terminée par la valeur nulle). 


vq_mouse fonction 124 
Retourne la position de la souris et l’état courant de ses boutons. 


int id vdi, etat bt, xsour, ysourÿ 


va_mouse (id _vdi, etat_bt, xsour, ysour); 


Paramètre d’appel : 
id_vdi (contrl{6)) : identificateur VDI. 


Paramètres de retour : 

état_bt (intout{0]) : Le bit 0 correspond au bouton le plus à gauche, le bit 1 
au second bouton en partant de la gauche, etc. 
Si le bit est mis à 1, alors bouton correspondant enfoncé. 

xsour (ptsout{0]) : coord. X de la souris. 

ysour (ptsout{1]) : coord. Y de la souris. 
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vq_key _s fonction 128 


Retourne l’état courant des touches SHIFT, CONTROL et 
ALTERNATE. 


int id_vdi, etat; 


va_key_s (id_vdi, &etat); 


Paramètre d'appel : 
id_vdi (contrl[6]) : identificateur VDI. 


Paramètre de retour : 

état (intout|0]) : si le bit est à 1, la touche est pressée. 
bit 0 = SHIFT (droite), bit 1 = SHIFT (gauche), bit 2 = CONT, | 
bit 3 = ALT | 


Fonctions de copie de zones 


Ces fonctions opèrent des copies de zones rectangulaires, de mémoire 
à mémoire et octet par octet, depuis une source vers une destination, en uti- 
lisant une opération logique spécifique. 


Ces copies sont fréquemment utilisées soit dans le sens « mémoire d’écran 
vers mémoire tampon » afin de sauvegarder une image, soit dans le sens con- 
traire afin de restituer l’image précédemment sauvegardée. 


Chaque argument de la copie, qu’il soit source ou destination, est défini 
par une structure MFDB, spécifiant son adresse, sa taille, l'opération logi- 
que à effectuer, etc. (cf. instr. AOOE, chap. 3.3.). 


vro_cpyfm fonction 109 


Copie une zone source rectangulaire vers une zone destination (les deux 
blocs de bits source et destination étant définis par une structure MFDB) 
en fournissant comme arguments, l'opération logique spécifiée, les coordon- 
nées des rectangles source et destination, ainsi que les adresses des deux struc- 
tures MFDB (cf. chap. 3.3. instr. A007 et AO0E). 

Si zone source et zone destination ont des coordonnées différentes, la l 
copie est indicée sur la source. 
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int id_vdi, op.1l09, coord_xy C8]; 
FDB *source, *dest; 


vro_cpyfm tid_vdi, op_1ag, voord_xy, source, dest); 


Paramètres d‘appel : 

id_vdi (contrl{6l) : identificateur VDI 

op_log (intin[0]) : opération logique entre source et destination 

coord_xy[0] (ptsin{0]) : coord. X d’un coin du rectangle source 

coord._xy[1] (ptsin[1]) : coord. Y de ce même coin 

coord_xy[2] (ptsin[2]) : coord. X du coin du rectangle source 
diagonalement opposé par rapport à coord_xy[0] 

coord_xy[3] (ptsin[3]) : coord;. Y de ce même coin 

coord_xyl4] (ptsin[4]) : coord. X d’un coin du rectangle destination 

coord._xy{5] (ptsin(5]) : coord. Y de ce même coin 

coord_xy{6] (ptsin{6l) : coord. X du coin du rectangle destination 
diagonalement opposé par rapport à coord. xy[4] 

coord_xy[7] (ptsin{7]) : coord. Y de ce même coin 

source (contrl[7] et [8]) : adresse pointant sur la structure FDB source 

dest (contrl[9] et [10]) : adresse pointant sur la structure FDB destination 


vrt_ cpyfm fonction 121 


Cette fonction, variante de la précédente, copie une zone source monoch- 
rome, en transformant, dans la destination, les deux couleurs de base par 
les couleurs dont l'index est spécifié. 

Seules les quatre premières opérations logiques sont autorisées. 


int id vdi, op_lag, coord.xy (91, index C2]; 
FDB *source. idest; 


vrt_cpyfm (id_vdi, op_log, coord._«y, source, dest, index); 


Paramètres d’appel : 

id_vdi (contrl[6l) : identificateur VDI 

op_log (intin{0]) : opération logique entre source et destination 

index{0[{intin[1]) : index de couleur remplaçant les pixels 1 de la source 

index[1]Gntin{2}) : index de couleur remplaçant les pixels 0 de la source 

coord_xy{0] (ptsin{0]) : coord. X d’un coin du rectangle source 

coord_xy{1] (ptsin[1]) : coord. Y de ce même coin 

coord_xy[2] (ptsin[2]) : coord. X du coin du rectangle source 
diagonalement opposé par rapport à coord_xy{0] 
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coord_xy[3] (ptsin{3]) : coord. Y de ce même coin 

coord_xy{4] (ptsin{4]) : coord. X d’un coin du rectangle destination 

coord_xy{5} (ptsin[5]) : coord. Y de ce même coin 

coord_xy|6] (ptsin{(6]) : coord. X du coin du rectangle destination 
diagonalement opposé par rapport à coord_xy[4] 

coord_xy{7] (ptsin[7]) : coord. Y de ce même coin 

source (contri[7] et [8]) : adresse de Ja structure MFDB source 

dest (contrl{9] et [10)) : adresse de la structure MFDB destination 


vr_trnfm fonction 110 


Recopie une structure MFDB source dans une MFDB destination en bas- 
culant le drapeau fd-stand (cf chap. 3.3. instr. A0007) transformant ainsi 
un bloc dépendant du périphérique en bloc standard, ou réciproquement. 


int id vdi; 
FDB source, Xdest; 


vretrnfm (id vdi, source, dest); 


Paramètres d’appel : 


id_vdi (contrl[6l): identificateur VDI 
source (contrl|7] et [8]) : adresse de la structure MFDB source 
dest (contrl[9] et [10]) : adresse de la structure MFDB destination 


Fonctions de police de caractères 


yst_load_fonts fonction 119 


Cette fonction initialise les paramètres d’une ou plusieurs polices utili- 
sateur. L'appel en C s’effectuant de façon incomplète, il est nécessaire d’ajou- 
ter des arguments par une routine assembleur (cf, chap. 3.1.3.). Retourne 
un identificateur de police(s). 


int id vdi, zero, id_pol; 


id_pol = vst load fonts {id, vdi, zero); 


Paramètre d'appel : 


id_vdi (contri{6)) : identificateur VDI. 
zero (intin[0]) : réservé, doit être à 0. 
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Paramètre de retour : 
id_pol (intout{0}) : identificateur de la nouvelle police. 


vyst_font fonction 21 
Sélectionne la police à employer pour toute écriture graphique ultérieure. 


int id vdi, id_pol, sel_pol; 


sel pot = vst_font (id_vdi, id_pol); 


Paramètres d'appel : 


id_vdi (contrl[6]) : identificateur VDI. 
id pol (intin{0]) : identificateur de police (1 = police-système). 


Paramètre de retour : 
sel_pol (intout{0]) : la police effectivement sélectionnée. 


vqt_name fonction 130 
Retourne une chaîne de 32 caractères précisant le nom et le style de la 
police spécifiée. 


int id_vdi, nu_ord, id.pol; 
char nom [32]; 


id_pal = vat.name (id_vdi, nu_ord, nom)} 


Paramètres d'appel : 


id_vdi (contrl[6]) : identificateur VDI. 
nu_ord (intin{0]) : numéro d’ordre (1 pour police système). 


Paramètres de retour : 

id_pol (intout|0]) : identificateur de police. 

name[0] à [15] (intout{1] à [16]) : nom (en ASCII). 
name/16]} à [31] (intout[17] à [32}) : le style (en ASCIT). 


vat_fontinfo fonction 131 


Retourne des informations sur la police de caractère courante, en tenar= 
compte de la taille (vst_height) et des effets spéciaux (vst_effects) sélectionnés. 
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Voir également le schéma 
dans vst_alignment. 


1 offset droite 


offset gauche 
delta X 


int id_vdi, mink, maxk, max_cel, rens [5], effet [CS]; 


vat_fontinfo (id vdi, &mink, &maxk, rens, &max.cel, effet): 


Paramètre d'appel : 
id_vdi (contrl[6]) : identificateur VDI 


Paramètres de retour : 


mink (intout{0]) : code ASCII du premier caractère dans la police. 
maxk (intout{1]) : code ASCII du dernier caractère dans la police. 
max_cel (ptsout{0]) : largeur max. de cellule (effets non-inclus). 
rens{0] (ptsout{1]) : écart entre ligne basse et ligne de base. 

rens[1] (ptsout{3]) : écart entre ligne inférieure et ligne de base. 
rens[2] (ptsout|5]) : écart entre demi-ligne et ligne de base. 

rens{3] (ptsout{7]}) : écart entre ligne supérieure et ligne de base. 
rens[4] (ptsout{9]) : écart entre ligne haute et ligne de base. 
effet{0] (ptsout[2]) : delta X (voir schéma ci-dessus). 

effet{1] (ptsout|4]) : offset gauche. 

effet{2| (ptsout{6]) : offset droit. 


vst_unload fonts fonction 120 


Désactive la (ou les) police(s) initialisées par vst_load_fonts. 
int id,vdi, id_pol; 


vst_unload fonts (id vdi, id_ pol); 
Paramètre d'appel : 


id_vdi (contrl[6|) : identificateur VDI. 
id_pol (intin{0|) : identificateur de la police à désactiver. 
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Fonctions d'imprimante 


yst_point fonction 107 


Spécifie, en points imprimables, la hauteur de cellule du caractère gre- 
phique. Un point est équivalent à 1/72 de pouce (soit 0.353 millimètres). 


int id vdi, sel, point, k_1g, kht, cel _1g, cel.ht; 


sel = vst_point (id vdi, point, &k_1g, &k.ht, &cel.1g, &keel ht); 


Paramètres d’appel : 


id_vdi (contri[6]) : identificateur VDI. 
point (intin[0]) : nombre de points définissant hauteur cellule. 


Paramètres de retour : 
sel (ntout{0]) : hauteur sélectionnée, en points. | 
k_lg (ptsout[0]) : largeur du caractère en pixels. 

k_ht (ptsout{1]) : hauteur du caractère en pixels. | 
cel_Ig (ptsout{2}) : largeur de cellule en pixels. 
cel_ht (ptsout{3]) : hauteur de cellule en pixels 


v_hardcopy fonction 5, sous-fonction 17 
Recopie sur imprimante, point par point, l'intégralité de l’écran. 
nt id vdi; 


v_hardcopy (id.vdi); 


Paramètre d’appel : id_vdi (contrl|6l) : identificateur VDI. 


Fonctions vectorisées 


Ces fonctions permettent de modifier les adresses de branchement = 
certaines routines d’interruptions et vous autorisent donc à en prendre le ca=- 
trôle en fournissant l'adresse de votre propre routine. 

L'utilisation de ces fonctions nécessite bien entendu prudence et riguexx. 


Notez qu’à l'entrée de votre routine, le système a déjà masqué les inter 
ruptions mais n’a pas sauvegardé ses registres. 
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vex_timv fonction 118 


Modifie l’adresse d’interruption timer, 


vex_butv fonction 125 

Modifie l’adresse des interruptions boutons de souris. Exécutées 
lorsqu'un bouton de la souris a été pressé. 
vex_motv fonction 126 

Modifie le branchement de la gestion d’affichage de la souris. Exécutée 
à chaque déplacement de celle-ci. 
vex_curv fonction 127 


Modifie l'adresse de la routine de retour d’affichage souris. Exécutée 
lorsque la souris a été tracée. 


Ces quatre fonctions utilisent les mêmes arguments : 


int id vdi, Hnouv_adr, Xanc_adrs 


“nom de la fonction" {id vdi, nouvadr, anc adr); 


Paramètres d'appel : 


id_vdi (contrl[6)) : identificateur VDI. 
nouv_adr (contri[7 et 8] ) : adresse de la nouvelle routine. 


Paramètres de retour : 
anc_adr (contri[9 et 10]) : ancienne adresse de la routine 


Note : vex_timv retourne dans intout [0] l'intervalle d’interruption en milli- 
secondes. 


Les fonctions AES 


Lorsqu'une application GEM souhaite utiliser les fonctions ABS, elle 
se fait identifier par l’ordonnanceur ABS qui lui fournit un numéro spécifi- 
que (g1_apid), libère l’espace mémoire requis pour sa gestion, et initialise les 
paramètres suivants (15 mots) : 
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global (0) : un mot spécifiant la version AES utilisée, | 0101 |. 

global (1) : un mot précisant le nombre d’application que cette version de 
P'AES supporte concurremment. [ 1 ] (bien que plusieurs puis- 
sent être sur la liste d’attente). 

global (2) : le numéro d’application (gl apid). 

global (3) et (4) : un long mot réservé à l’application. 

global (5) et (6) : un long mot qui contiendra, après l’appel de la fonction 
rsrc_load, l'adresse de départ de }’arbre ressource. 

global (7) et (8) : réservé. 

global (9) et (10) : réservé. 

global (11) et (12) : départ des en-têtes d’application. | $38DFA |. 

global (13) et (14) : réservé. 


A chaque appel d’une fonction AES, sont d'autre part initialisés cinq 
tableaux que nous ne ferons que nommer puisque, contrairement au VDI, 
le programmeur n’a guère à s’en soucier. Il s’agit de : 


param _: tableau d’adresses des zones de paramètres. 
control _: zone de contrôle de la fonction. : 
int_in : zone des valeurs 16 bits en entrée. 


addr in : zone des valeurs 32 bits (adresses) en entrée. 
int out : zone des valeurs 16 bits en sortie. 
addr_out : zone des valeurs 32 bits (adresses) en sortie. 


REMARQUES GÉNÉRALES : 
Tout au long de l'annexe, lorsqu'un objet ou une fenêtre sont position- 


nés par leurs coordonnées, celles-ci réfèrent TOUJOURS à leur coin supé- 
rieur gauche. 


Pour un certain nombre de constantes utilisées par PAES, ont été indi- 
quées, en lettres majuscules, leurs noms symboliques, tels qu’ils sont recon- 
nus par le fichier GEMDEFS.H du compilateur DIGITAL RESEARCH. 
Avant de les utiliser, il convient de vérifier, pour tout autre compilateur, leurs 
authenticités. 


Gestion de l'application 


appl_init fonction 10 


Lance l’application en réservant l’espace mémoire nécessaire aux para- 
mètres internes de l’AES et en utilisant le tableau GLOBAL (voir plus haut)- 


Retourne l’identificateur de l’application. 
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Un accessoire doit déclarer gl_apid comme variable externe. 


int gl_apid; 


gl_apid = appl init € ); , 


Paramètre de retour : 
gl apid (int_out{0]) : identificateur de l'application 
si — 1, une erreur existe, l’application ne peut être ouverte. 


appl_write fonction 12 
Envoie un nombre spécifié d’octets dans un canal de communication 


permettant le dialogue entre applications (cf appl_read). 


int ret, ap_idec, nb_oc; 
char tamp Cnb_oc]: 


ret = appl.write (ap_id, nb_oc, tamp); 


Paramètres d‘appel : 


ap_idec (int_in{0]) : l’identificateur de Papplication destinatrice. 
nb_oc (int_in[1]) : nombre d’octets à envoyer. 
tamp (addr_in|0]) : adresse du tampon contenant le message. 


Paramètres de retour : 
ret (int_out[0}) : si 0, une erreur existe 


appl_ read fonction 11 
Lit le nombre spécifié d’octets envoyés par une autre application. ' 


int ret, ap_idl, nb_ac; 
char tamp Cnb_oc]; 


ret = appl read (ap idl, nb_oc, tamp); 


Paramètres d'appel : 

ap_idl (int_in|0]) : l’identificateur de l’application réceptrice 
nb_oc (int_int{1]) : nombre d’octets à lire. Ù 
tamp (addr_ïin [0}) : adresse du tampon contenant le message 
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Paramètre de retour : 
ret (int_out{0]) : si 0, une errreur existe 


appl_find fonction 13 
Retourne l’identificateur d’une application dont le nom de fichier est 
spécifié. 
int ap_idt; 
char nom [91; /* terminé par la valeur nulle */ 


apidt = appl.find (nom); 


Paramètre d’appel : 


nom (addr_in[0]) : adresse de la chaîne « nom » qui doit obligatoirement 
comporter 8 caractères (au besoin, complétée par des espaces). 


Paramètre de retour : 


ap_idt (int_out{0]) : identificateur de l’application recherchée. 
Si ap_idt = —1, l'AES n’a rien trouvé. 


appi_trecord fonction 15 
Enregistre dans un tampon un nombre donné d'événements en Prove- 
nance de l’utilisateur. 


Un bogue, dans la routine AES qui doit traduire l'événement en un code 
spécifique (cf ci-dessous), rend la fonction difficilement utilisable puisqu’est 
stockée, à la place du code, l'adresse de la routine qui a géré l'événement. 


Espérant qu’une correction sera effectuée avant l'implantation du système 
en ROM, nous vous donnons ici les valeurs telles qu’elles devraient être 
enregistrées. 


Chaque événement est stocké sur deux longs mots. 
ŒUIT octets et non six comme dans le GEM d'IBM) 


Le premier long mot représente(ra) la nature de l’événement : 
0 = timer, 1 bouton, 2 = souris, 3 = clavier. 


Le deuxième long mot dépend de l'événement : 
si timer, le nombre de millisec. écoulées (en multiple de 20 m/sec). 
si bouton, mot faible = état des boutons (cf evnt_mouse) 
mot fort = nombre de cliquages 
si souris, mot faible = coord. X, mot fort = coord. Y. 
si clavier, octet faible du mot fort = code ASCII 
octet fort du mot fort = code clavier (trap 1 fonction 1) 
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int nb.ev, ret_av; 
long adr _ev; ZX nombre d’octets necessaires = nb_ev + 9 */ 


ret_ev = appl_trecord (adr_ev, nb_ev); 


Paramètre d'appel : 


nb_ev (int_in{0]) : nombre d’événements à stocker. 
adr_ev (addr_in[0}) : adresse où seront stockés les événements. 


Paramètre de retour : ret_ev Gnt_out [0]) : nombre d'événements stockés 


appl_tplay fonction 14 
Exécute, à la vitesse spécifiée, les événements enregistrés par appl_trecord. 


int nbev, vit; 
long adr_ev; 


appl_tplay (adr.ev, nb_ev, vit} 


Paramètres d’appel : 

nb_ev (int_in[0]) : nombres d'événements à exécuter. 

vit (int_in{1}) : une valeur entre 1 et 10 000 déterminant la vitesse d’exécu- 
tion par rapport à l’enregistrement. 
50 = vitesse / 2, 100 = idem, 200 = vitesse « 2, etc. 

adr_ev (addr_in{0]) : adresse de stockage de l’enregistrement. 

appl_exit fonction 19 

Désinitialise l’application courante, libère l’espace mémoire réservé par la 

fonction appl_init. 


int ret; 


ret = appl_enit (); 


Paramètre de retour : xet (int_out{0]) : si 0, une erreur existe. 


Gestion des événements 


Lors de l’attente d’un événement, le retour à l'application ne s’opère 
que lorsque la condition de sortie a été réalisée, 
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evnt_keybd fonction 20 

Attend qu'une touche du clavier soit pressée. 
Les touches SHIFT, CONTROL et ALTERNATE ne provoquent pas à elles 
seules la sortie de la fonction, mais leur état peut être testé par la fonction 
graf_mkstate. 


int ev.clret; 


ev_ciret = evnt_keybd { ); 


Paramètre de retour : 


ev_ciret (int_out[0]) : octet faible = code ASCII de la touche appuyée 
octet fort = code de la touche 


evnt_button fonction 21 


Attend qu’un bouton de la souris soit dans l’état spécifié. 


int nb_elic, masques etat _be; 
int clic_s, Sourx, SOUTY) etat_bs, etat el; 


clic.s = evnt.button Inb_clic, masques etat_be, 
tesourx, dsaury, tetat_bs, tetat._cl); 


Paramètres d’appel : 
nb_clic (int_in[0]) : nombre de cliquages attendus. 

Permet de définir le nombre de fois qu’un bouton doit entrer dans son 
état de sortie (et ce durant le laps de temps spécifié par evnt_dclick), avant que 
je retour de la fonction ne s'effectue. 


masque (int_in{1]) : le(s) bouton(s) à tester (en théorie 16). 

Sachant que le bit d’ordre 0 correspond au bouton le plus à gauche de 
la souris, on détermine le ou les boutons de sortie en mettant à 1 le(s) bit(s) 
leur correspondant. Tout bit mis à 0 masque l’état du bouton qui lui est dévolu 
et le rend invalide, 

Ex : $0001 ne laisse « répondre » que le bouton gauche de la souris. 


état_be (int_in[2}) : l’état du bouton qui doit provoquer le retour : 
bit correspondant = 0 — retour lorsque appui du bouton. 
bit correspondant = 1 — retour lorsque relâchement du bouton. 


Paramètres de retour : 
clic_s (int_ out{0)) : nombre de cliquages qui ont provoqué le retour. 


194 


Valeur comprise entre 1 et valeur spécifiée dans nb _clic. 
sourx (int_out[1]) : coord. X de la souris au retour. 
soury (int_out{2]) : coord. Y de la souris au retour. 
etat bs (int out{[3]): état du bouton qui a occasionné le retour. 
Si bit à 1 = bouton pressé, bit à O sinon. 
etat_cl (int_out{4]) : état des touches spéciales du clavier. 
Si le bit correspondant est à 1, la touche était enfoncée : 
bit 0 = SHIFT (droit) 
bit 1 = SHIFT (gauche) 
bit 3 = CONTROL 
bit 4 = ALTERNATE 


WI 


evnt_mouse fonction 22 
Attend que la souris entre ou sorte d’une zone rectangulaire spécifiée. 


in drap, x_in, y_in, larg, haut ; 
int sourx, soury, état_bs, état_cl : 


evnt_mouse (drap, x_in, y_in, larg, haut, 
&sourx, &soury, &état_bs, &état_cl) ; 


Paramètres d'appel : 


drap (int_in[0]) : drapeau précisant à l’AES la raison du retour. 
Si drap = 0, retour de fonction si la souris entre dans rectangle. 
Si drap = 1, retour de fonction si la souris sort du rectangle. 
x_in (int_in{1]) : coord. X du rectangle 
ÿ_in (int_in {2]) : coord. Y du rectangle. 
larg (int_in(3]) : largeur du rectangle en pixels. 
haut (int_in{4]) : hauteur du rectangle en pixels. 


Paramètres de retour : 


sourx (int_out{1]) : coord. X du pointeur de souris au retour. 
soury (int_out{[2]) : coord. Ÿ du pointeur de souris au retour. 
état_bs (int_out[3l) : état des boutons de la souris au retour. 
Voir fonction précédente. 
état_cl (int_[4]) : état des touches spéciales du clavier. 
Voir fonction précédente. 


evnt_mesag fonction 23 


Attente d’un message envoyé par l’AES dans un tampon spécifié. 
Le tampon, dont l’adresse est envoyée à la fonction, doit avoir une taille 
minimum de huit mots (soit seize octets). 
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Quelque soit le message envoyé par l’AES, les trois premiers mots réfè- 
rent toujours au même contenu : 


mot 0 : numéro identifiant le type de message. 

mot 1 : identificateur AES de l'application qui envoie le message. 

mot 2 : la longueur du message sans inclure les seize premiers octets. 
Si son contenu est nul, cela signifie que le message envoyé tient dans 
les huit mots. Dans le cas contraire, un appel à la fonction appl_ read 
fournira le reste du message. 


Voici la liste des différents messages envoyés par l’AES, leurs significa- 
tions, ainsi que le contenu spécifique du tampon pour chaque cas : 


* indique qu’un item du menu a été sélectionné. 
mot 0 : 10 MN _SELECTED 
mot 3 : L'index d’objet du titre du menu sélectionné. 
mot 4 : L’index d'objet de l’item du menu sélectionné 


«Indique un cliquage dans une fenêtre inactive. 
mot 0 : 21 WM_TOPPED 
mot 3 : l’identificateur de la fenêtre à activer. 


indique un cliquage dans la case de fermeture de fenêtre. 
mot0:22  WM_CLOSED 
mot 3 : l’identificateur de la fenêtre à fermer. 


«Indique un cliquage dans la case de pleine-fenêtre spécifiant le plus grand 
élargissement possible de la fenêtre ou, si c’est déjà le cas, le retour à sa taille 
antérieure, 
mot 0 : 23 WM._FULLED 
mot 3 : lidentificateur de la fenêtre. 


Indique un cliquage soit sur les flèches blanches de la barre de défile- 
ment, soit sur cette barre elle-même, spécifiant une demande de déplacement 
de la partie visible de la fenêtre. 
mot 0:24 WM_ARROWED 
mot 3 : l’identificateur de fenêtre. 
mot 4 : l’action requise selon la localisation du cliquage. 


= partie grisée verticale — page supérieure demandée 
= partie grisée verticale — page inférieure demandée 
= flèche verticale sup. — rangée supérieure 
= flèche verticale inf. — rangée inférieure 


partie grisée horizontale. — page de gauche 
partie grisée horizontale — page de droite 
flèche horizontale gauche — colonne gauche 
flèche horizontale droite — colonne droite 


un 


3 à LR & Dm © 
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* Indique que l'utilisateur a déplacé l’ascenseur horizontal. Le message 
est retourné lorsque le bouton de souris est relâché, 
mot 0 : 25 WM_HSLID 
mot 3 : l’identificateur de fenêtre 
mot 4 : une valeur comprise entre 0 (position la plus à gauche) et 1 000 (posi- 
tion la plus à droite), précisant la position requise. 


* Déplacement de l’ascenseur vertical requis par l’utilisateur. 
mot 0 : 26 WM_VSLID 
mot 3 : l’identificateur de la fenêtre 
mot 4 : une valeur comprise entre 0 (position la plus haute) et 1 000 (posi- 
tion la plus basse), précisant la position requise. 


+ Indique que l’utilisateur a modifié la taille de la fenêtre. Le message 
est envoyé au relâchement du bouton de la souris. 
mot 0 : 27 WM_SIZED 
mot 3 : l’indentification de la fenêtre. 
mot 4 : coord. X de la fenêtre (en théorie, inchangée). 
mot 5 : coord. Y de la fenêtre (en théorie, inchangée), 
mot 6 : largeur de fenêtre requise. 
mot 7 ; hauteur de fenêtre requise. 


+ Indique que l’utilisateur a déplacé la fenêtre. 
mot 0:28 WM MOVED 
mot 3 : l’identificateur de la fenêtre déplacée. 
mot 4 : la nouvelle coordonnée X requise. 
mot 5 : la nouvelle coordonnée Y requise. 
mot 6 : largeur de la fenêtre (en théorie, inchangée). 
mot 7 : hauteur de la fenêtre (en théorie, inchangée), 


*L’AËS indique à l’application que sa fenêtre doit être activée. 
mot 0 : 29 WM_NEWTOP 
mot 3 : l’identificateur de la fenêtre à activer. 


*{ndique qu’un retraçage de la zone spécifiée est nécessaire, 
mot 0 : 20 WM_REDRAW 
mot. 3 : l’identificateur de la fenêtre à retracer. 
mot 4 : coordonnée X de la portion d’écran à retracer. 
mot 5 : coordonnée Y de la portion d’écran à retracer. 
mot 6 : largeur de cette même portion. 
mot 7 : hauteur de cette même portion. 
L'ordre de retraçage est envoyé après l’un des événements suivants : 


— un FULL_SIZE s’il implique un agrandissement de la fenêtre. 
— un WM_SIZED si taille demandée est plus grande que la précédente. 
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— à chaque fois qu’un objet (forme dialogue, etc. .) a effacé tout ou partie 
de votre fenêtre. 


* Indique à un accessoire que litem du menu « Bureau » le désignant 
a été sélectionné. 
mot 0 : 40 AC_OPEN 
mot 4 : l’identificateur de l’item du menu (cf menu register). 
+ Indique à un accessoire que l’AES exige sa fermeture. 
mot 0 : 41 AC CLOSE 
mot 3 : l’identificateur de l’item du menu (cf. menu_register) 
Le message AC_CLOSE est envoyé par l’AES dans les trois cas suivants : 
— Fapplication courante est terminée. 
— un effacement d’écran est demandé. 
— Ja structure de fenêtrage est réinitialisée. 
int tampon C8]; 


evnt_mesag (tampon); 


Paramètre d’appel : 
tampon (addr_in{0]) : adresse du tampon recevant les messages. 


evnt_timer fonction 24 


Attente d’un événement de l’horloge interne selon un délai spécifié. 


L'intervalle de temps qui s’écoule entre l’appel et le retour de fonction 
est précisé dans deux mots. 


int bas del, haut_del; 


evnt_timer (bas_del, haut_del); 


Paramètres d’appel : 
bas_del (int_in[0]) : valeur basse du délai en millisecondes. 
haut_del (int_in[1]) : valeur haute du délai en millisecondes. 


evnt-multi fonction 25 

Attente simultanée de plusieurs événements. 

Les événements attendus peuvent comprendre tout ou partir de ceux défi- 
nis précédemment (souris, bouton, message, clavier, timer). 
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Les composantes de cette fonction sont en grande partie celles déjà 
employées pour les événements particuliers, la seule « nouveauté » consis- 
tant en la possibilité de définir deux événements-souris, correspondant cha- 
cun à l’entrée ou à la sortie d’une zone rectangulaire spécifique (MU_ M1 
et MU_M). 


int type.ev, nb_clic, masque, etat_be, drapi, x_ini, y_int; 
int Largi, hauti, drap2, x_in2, y_in2, larg2, haut2; 
int tampon [81, bas_del, haut_del; 


int ev_quel, sourx, soury, etat bs, etat cl, ev clret, clic 5; 


ev_quel = evnt_multi (type ev, nb.clic, masque, etat _be, drapi, 
x int, yint, largi, hauti, drap2, x in, int, larga, 
hautZ, tampon, bas del, haut del, &sourx, &soury, 
&etat bs, tetat cl, &etat_ciret, &clic 5); 


Paramètres d’appel : 


type_ev (int in{0]) : type des événements attendus. 
Chaque bit de cette variable mis à 1 spécifie les événements qui seront 

pris en compte par la fonction : 
0x0001 MU_KEYBD = attente clavier. 
0x0002 MU_ BUTTON = attente du bouton spécifié, 
0x0004 MU M1 = attente de la souris par rapport au rectangle 1. 
0x0008 MU_M2 = attente de la souris par rapport au rectangle 2. 
0x0010 MU_MESAG = attente d’un message dans le tampon. 
0x0020 MU_TIMER = attente d’un délai d'horloge. 
Ex : type _ev — 0x003 ou type ev = MU KEYBD | MU BUTTON 
indique que la fonction attend un événement clavier ou bouton. 

nb_clic (int_in{[1]) 

masque (int_in[2)) : voir evnt_button 

état _be (int_in[3]) 

drapi (int_in[4)) 

xini (int in(5) 

ÿ_inl (int_in(6)) ; voir evnt_mouse (MU M1) 

largl Gt Inf?] 3 

haut1 (int_in| } 

drap2 (int_in[9}) 

xin2 (int in{10]) 

ÿin2 (intin[11) : evnt_mouse (MU M2) 

larg2 (int_in[12]) : 

haut2 (int_in[13]) 


bas_del (int_in{14}) : voir evnt_timer 
haut_del (int_in[15]) : # 
tampon (addr_in[0]) : “adresse du tampon de message 
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Paramètres de sortie : 


ev_quel (int_out[0]) : le type d'événement (l’un de ceux demandés dans 
type_ev) qui a provoqué le retour de la fonction. 

sourx (int_out[1]) : coord. X de la souris au retour. 

soury (int out{2]) : coord. Y de la souris au retour. 

etat_bs (int_out[3]) : état des boutons (cf. evnt_button). 

etat_cla (int_out[4]) : touches spéciales clavier (cf evnt_button) 

ev_ciret (int_out{5|) : touche clavier appuyée (cf. evnt_keybd). 

clic_s (int_ out{6]) : nombre de cliquages (cf. evnt_button). 


evnt_dclick fonction 26 

Demande ou spécifie l'intervalle de temps entre deux cliquages pour que 
ceux-ci soient considérés comme double-clic (cf. Panneau de Contrôle dans 
le Bureau). 
int vit de, drap_de, sel. de; 


sel_de = evnt_delick (vit de, drap. dc); 


Paramètres d'appel : 


vit_de (int_in[0]) : nombre compris entre O (le plus lent) et 4. 
0 = 450 millisec., 1 = 330, 2 = 275, 3 = 220, 4 = 165. 

drap_de (intin{[1]) : drapeau spécifiant s’il s’agit d’une demande (si 0) ou d’ure 
indication à l’AES (si 1). 


Paramètre de retour : 
sel_ de (int_out[0]) : retourne la vitesse sélectionnée. 


Gestion des menus 


menu_bar fonction 30 
Affiche ou supprime la barre des menus de l'application. 


int drapenn, ret; 
long adr.mn; 


ret = menu_bar (adr_mn, drap_mn); 
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Paramètres d'appel : 
drap_mn (int_in[1]): si O, retire la barre des menus. 


si 1, affiche la barre des menus. 
adr_mn (addr_in{0)) : adresse de l’arbre qui définit le menu. 


Paramètre de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


menu _icheck fonction 31 


Affiche ou supprime un « check » (v = caractère de validation) à côté 
d’un item de menu. 


int nitem, dp_cit, ret; 
Jong adr, mn: 


ret = menu_icheck (adr_mn, nitem, dp_cit); 


Paramètres d’appel : 
n_item (int_in{0]) : index de l’item dans l’arbre-menu. 
dp_cit (int_in[1]) : si 0, efface le « check » s’il existe. 
si 1, affiche un « check ». 
adr_mn (addr_in[0]) : adresse de l’arbre qui définit le menu. 


Paramètre de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


menu_jienable fonction 32 


Active ou désactive un item de menu. S’il est inactif, un item est affiché 
avec une intensité réduite et sa sélection est impossible. 


int n_item, dp_ ait, ret; 
long adr.mn; 


ret = menu jenable (adr_mn, n_item, dp_ait); 


Paramètres d'appel : 
n_item (int_in{[0}) : index de l’item dans l’arbre-menu. 
dp_ait (int_in[1]) : si 0, désactive l’item de menu. 
si 1, active l’item de menu. 
adr_mn (addr_in|0]) : adresse de l’arbre qui définit le menu. 
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Paramètres de retour : 
ret (int_out{0]) : si O0, une erreur existe. 


menu _tnormal fonction 33 

Affiche un titre de menu en vidéo normale ou inverse. 
int n_titre, dp.vtit, ret; 
long adr._mn; 


ret = menu_tnormal (adr_mn, n_titre, dp_vtit); 


Paramètres d’appel : 
n_titre (int_in[0]) : index du titre dans l’arbre-menu. 
dp_vtit (int_in[1}) : si 0, affiche en vidéo inverse. 
si 1, affiche en vidéo normale. 
adr_mn (addr_in{0]) : adresse de l’arbre qui définit le menu. 


: Paramètre de retour : 
| | ret (int_out[0}) : si 0, une erreur existe. 


menu_text fonction 34 
Remplace le texte d’un item de menu. 


int nitem, ret; 
char texte Ciz /* chaine termine par un caractere nul */ 
long adr_man; 


_. 


ret = menu_text Cadr.mn, n_item, texte); 


Paramètres d'appel : 

n_item (int_in{0]) : index de l'item dans l’arbre-menu. 

adr_ mn (addr_in{0]) : adresse de l'arbre qui définit le menu. 

texte (addr_in[1]) : adresse du nouveau texte (qui ne peut être plus long 
que l’ancien). 


—t— 


Paramètre de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


menu register fonction 35 
Place le titre d’un accessoire dans le menu « Bureau ». 
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int gl_apid, n_acit; 
char titre L 1; 


nacit = menu register (gl_apid, titre): 


Paramètres d'appel : 
gl_apid (int_in|[0)) : identificateur de l’accessoire (cf. appl_init). 
titre (addr_in{0}) : adresse de la chaîne. 


Paramètres de retour : 
u_acit (int_out{0]) : index de l’item (de 0 à 5). Si —1, erreur. 


.Gestion des objets 


objc_add fonction 40 
Ajoute un objet à un arbre en définissant ses inter-relations. 


int ob_par, ob_enf, rets 
long adr_arb; 


ret = objc_add (adr_arb, ob par, ob_enf); 


Paramètres d'appel : 

ob_par (int_in{0]) : l'index du parent de l’objet ajoutée. 
ob_enf (int_in|1|) : l'index de l’objet lui-même. 

adr_arb (addr_in{0]) : adresse de l’arbre propriétaire de Pobjet. 


Paramètre de retour : 
ret (int_out{0}) : si 0, une erreur existe. 


objc_delete fonction 41 
Supprime un objet dans un arbre. 


int ob. sup, ret; 
long adr_arb; 


ret = objc_delete (adr_arb, ob_sup)s 
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Paramètres d'appel : 
ob_sup (int_in[0]) : l'index de l’objet à supprimer. 
adr_arb (addr_in|[0]) : adresse de l’arbre propriétaire de l’objet. 


Paramètres de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


obje_draw fonction 42 

Trace un objet et sa descendance, avec affichage restreint. 
int ob _deb, ob desc, x clip, y.clip, 1g_clip, ht_clip, ret; 
long adr_arb; 


ret = objc draw (adr.arb, ob_deb, ob._desc, x_clip, y_clip, 
1g_clip, ht clip); 


Paramètres d’appel : 
ob_deb (int_in{0]) : l’index du premier objet à tracer. 
ob_desc (int_in{1}) : niveau de descendance à tracer. 
si = 0, ne dessine que l’objet lui-même. 
si = 1, dessine l’objet + enfants de l’objet, etc. 
x_clip (int_in{2]) : coord. X du rectangle de restriction (cf vs_clip) 
y_clip (int_in[3]) : coord. Y de ce rectangle. 
lg_clip (int_in[4]) : largeur du rectangle. 
ht_clip (int_in{5]) : hauteur du rectangle. 
adr_arb (addr_in[0]) : adresse de l'arbre propriétaire de l’objet. 


Paramètre de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


obje_find fonction 43 

Cherche l’objet qui se trouve sous les coordonnées spécifiées, 
int ob_rech, rech_lim, # coor, y_coor, rep; 
long adr_arb; 


rep = objc_find (adr arb, ob_rech, rech.lim, x_coor, y.coor); 


Paramètres d’appel : 


ob_rech (int_in{0]) : index de l’objet par qui débute la recherche. 
rech_lim (int_in[1]) : niveau de descendance dans laquelle doit s'effectuer 
recherche (0, 1, 2, etc. cf fonction précédente). 
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x_coor (int_in{2]) : coord. X du point de recherche, 
y_coor (int_in[3]) : coord. Ÿ du point de recherche. 
adr_arb (addr_in{0]) : adresse de l’arbre propriétaire de l’objet. 


Paramètre de retour : 
rep (int_out{0]) : l’index de l’objet trouvé. Si —1 —> pas trouvé. 


objc_offset fonction 44 

Calcule et fournit les coordonnées d’un objet par rapport à l’écran. 
int ob_quel, x_ob;, y.ohi, ret; 
long adr_.arb; 


ret = objc_offset (adr arb, ob quel, &x_ob5, &y ob); 


Paramètres d’appel : 
ob_quel (int_in[0]) : index de l’objet dont on cherche les coord. 
adr_arb (addr_in[0]) : adresse de l’arbre propriétaire de l’objet. 


Paramètres de retour : 


ret (in_out[0}) : si 0, une erreur existe. 
x_obj (in_out[1}) : coord. X de l’objet 
ÿ_obj (int_out{2}) : coord. Y de l’objet. 


obje_order fonction 45 
Modifie l’ordre de disposition des objets. 


long adr_arb; 


ret = objc_order (adr.arb, ob.quel, ob_ pos); 


Paramètres d’appel : 

ob_quel (int_in{0]) : l’index de l’objet à déplacer. 

ob_pos (int_in[1]) : nouvelle position de l’objet (si O0 — dernier de la liste, 
si 1 — avant-dernier, etc... et si —1 — premier de la liste). 

adr_arb (addr_in[0)) : l'adresse de l’arbre propriétaire de l’objet. 


Paramètres de retour : 
ret (int_out[0]) : si 0, une erreur existe. 
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objc_edit fonction 46 


Permet d’afficher du texte dans un objet de type G_TEXT ou G_BOX- 
TEXT (cf la structure TEDINFO) 


int ret, ob_quel, carac, cur_in, aff_Ey, eur out.ÿ 
long adr_arb; 
ret = objc_edit (adr_ob;, ob.quel, carac, &cur_in, aff_ty); 
A l’adresse de cur_in on placera la position horizontale de départ 
et on y récupérera la position du curseur au retour. 
Paramètres d’appel : 
ob_quel (int_in[0]) : index de l’objet. 
carac (int_in[1]) : caractère à afficher. 
cur_in (int_in{2}) : position du caractère à afficher. 
aff_ ty (int_in|3]) : type d’affichage demandé (1, 2 ou 3) 
1'= fait apparaître le curseur, met à jour les contenus de la chaîne 
par défaut (te_petext) et du gabarit (te_ptmplt). 
2 = affiche le caractère si valide (te_pvalid). 
3 = supprime le curseur. 
adr_arb (addr_in{0]): adresse de l'arbre propriétaire de l'objet. 
Paramètres de retour : 
ret (int_out[0]) : si 0, une erreur existe, 
cur_out (int_out{1]) : position suivante du curseur. 


objc_change fonction 47 
Modifie l’état d’un objet et retrace l’objet, si demande en est faite, dans 
les limites de la zone « clip » (cf vs_clip du VDI). 


int ob_quel, x clip, v.clip, 19.clip, ht clip; 
int nv etat, dp_des, ret;s 
long adr_arb; 


ret = obje_change (adr.arb, ob.quel, O,x clip, y_clip, 19.clip, 
ht_clip, nv_etat, dp_des); 

Paramètres d’appel : 

ob_quel (int_in[0]) : index de l’objet à modifier. 

(int_in[1})} : réservé, toujours égal à zéro. 

x_clip (int_in{2]) : coord. X du rectangle de « clip » 

y_clip (int_in[3]) : coord. Y de ce rectangle 

lg_clip (int_in{4l) : largeur du rectangle 

ht_clip (int_in{5]) : hauteur du rectangle. 
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nv_état (int_in[6]) : nouvel état de l’objet (SELECTED), etc...). 
dp_des (int_in{7]) : drapeau de retraçage : 0 = ne pas retracer. 
1 = retracer. 


Paramètre de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


Gestion des formes 


form_do fonction 50 


Laisse l’AES gérer les interactions avec une forme de dialogue. L’appli- 
cation ne reprend le contrôle que lorsqu'une condition de sortie a été sélec- 
tionnée par l’utilisateur. 


int fo_act, foret; 
long fo .adr} 


fo_ret = form da (adr_arb, fo_act); 


Paramètres d'appel : 


fo_act (int_in{0]) : l'index objet du champ d’édition à activer à l'entrée dans 
le dialogue. Si pas de champ, fo_act = 0. 
adr_arb (addr_in{0]) : l'adresse de l’arbre propriétaire de la forme. 


Paramètres de retour : 
fo_ret (int_out{0]) : l'index objet responsable de la sortie du dialogue. 


form_dial fonction 51 
Dépend de la valeur d’un drapeau et agit comme suit : 


fo_dp = 0 FMD START : réserve un espace écran pour afficher une boîte 
dialogue. 
fo_dp = 1 FMD_GROVW (cf graf_growbox) : génère un effet visuel expan- 
sif donnant une illusion d’ouverture. 


fo_dp = 2 FMD SHRINK (cf graf_shrinkbox) : génère un effet visuel 
rétractif donnant une illusion de fermeture. 
fo_dp = 3 FMD_FINISH : libère l'espace écran, génère une demande de 


retraçage (cf evnt_mesag). 
int fo dp, *_pcoor, y_pcoor, 1 prect, h_prect; 
int x, geoor, ÿ_gcovr, à _grect, h_grects 


ret = form_dial (fo_dp, *_ pcoor, y _pcoor, 1_prect, h_prect, 
*_gcaor, y_gcoor, 1_grect, h_grect); 
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Paramètres d'appel : 


fo_dp (int_in{0]) : drapeau de fonction (voir ci-dessus). 
x_pcoor (int_in[1]) : coord. X de la petite boîte. 
Si GROW = source de l’expansion, si SHRINK = desti. de rétraction. 
y_pcoor (int_in[2]) : coord. Y de cette même boîte. 
1_prect (int_in[3]) : largeur de petite boîte. 
h_prect (int_in[4]) : hauteur de petite boîte. 
x_gcoor (int_in[5]) : coord. X de la grande boîte. 
y_gcoor (int_in{6]) : coord. Y de cette même boîte, 
L_ grect (int_in[7]) : largeur de grande boîte. 
h_grect (int_in[8]) : hauteur de grande boîte. 


Paramètres de retour : 
ret (int_out{0]) : si O, une erreur existe. 
NOTE : pour FMD_ START et FMD_FINISH, les valeurs de int_in[1] à 


int_in(4] ne sont pas prises en compte mais demeurent obligatoires pour le 
bon positionnement des paramètres. 


form_alert fonction 52 


Affiche une forme d’alerte dont les composants sont spécifiés dans la 
chaîne. Cette fonction gère elle-même la sauvegarde et la restitution d’écran. 


int daf_bout, bout sort; 
char chaine (13; /* 5 lignes de 30 caractères au maxi 


bout_sort = form_alert (def,bout, chaine); 


Paramètres d’appel : 


def_bout (int_in[0]) : bouton par défaut (si touche <RETURN>). 
0 = aucun, 1 = premier bouton, 2 = deuxième, 3 = troisième. 
chaîne (addr_in{0]) : adresse de la chaîne à afficher. 


Paramètres de retour : 
bout_sort (int_out{0|) : numéro du bouton sélectionné (1, 2 ou 3). 


form_error fonction 53 


Affiche une forme d'erreur dont le contenu est déterminé par le code 
demandé. Même remarque que pour form_alert. 


int bout-sort, cade; 


bout_sort = form_error (code); 
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Paramètre d’appel : code (int_in[0]) : code de l’erreur. 
de — 1 à — 17 = erreurs d’entrée-sortie (BIOS) 
de — 32 à — 49 = erreurs disques (DOS). 


Paramètre de retour : bout_sort (int_out|0]) : bouton sélectionné. 


form_center fonction 54 

Retourne les coordonnées, centrées sur l'écran, d’une boîte de dialogue. 
int ke, v.c, 19.0, htc; 
long fo_adr:s 


form center (fo_adr, 8x ec, &y_c, &lg ec, &ht_ 0); 


Paramètre d’appel : 
fo_adr (addr_in{0}) : adresse de l’arbre qui définit la forme. 


Paramètres de retour : 


x_c (int_out{1]) : coordonnée X centrée. 
y_c (int_out{2)) : coordonnée Y centrée. 
lg_c (int_out{3]) : largeur de la boîte de dialogue. 
ht_c (int_out[4]) : hauteur de la boîte de dialogue. 


Gestion graphique 


graf_rubberbox fonction 70 


Trace une boîte en traits pointillés, expansible ou rétractable par l’utili- 
sateur, mais fixe à son coin supérieur gauche. 


int b_x, by, 1g_min, htmin, fin_lg, fincht, ret;s 


ret = graf rubberbox (b_x, b_y, Ig,min, ht_min, 
&fin_19, «fin ht); 


Paramètres d'appel : 

b_x (int_in[0)) : coord. X de la boîte. 

b_y (int_in[1}) : coord. Y de la boîte. 

lg_min (int_in[2]) : largeur minimum de boîte. 
ht_min (int_in{[3]) : hauteur minimum de boîte. 
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Paramètres de retour : (au relâchement du bouton) 
ret (in_out{0]) : si 0, une erreur existe. 

fin_lg (int_out{1}) : largeur de boîte au retour. 
fin_ht (int_out{2]) : hauteur de boîte au retour. 


graf_dragbox fonction 71 


Trace une boîte en traits pointillés que les mouvements de souris dépia- 
cent tant qu’un bouton est pressé. 


int big, biht, b.x, by, limx, lim_y, lim_1g, limht; 
int ret, fin_x, fin_y} 


ret = graf_dragbox (b.1g, bLht, b_x, b_y, lim_xs lim_Ys 
lim_i9, dimht, &fin.x, &fin_y); 


Paramètres d’appel : 

b_Ig (int_in{0)) : largeur de la boîte à déplacer. 

b_ht (int_in|[1}) : hauteur de la boîte à déplacer. 

b_x (int_in[2]) : coord. X initiale de la boîte. 

b_y (int_in{3}) : coord. Y initiale de la boîte. 

lim_x (int_in{4]) : coord. X du rectangle de limite, zone dans lequel le dépla- 
cement est autorisé. 

lim_y (int_in{5]) : coord. y du rectangle de limite. 

lim_Jg(int_in|6] : largeur du rectangle de limite. 

äim_ht (int_in[7]) : hauteur du rectangle de limite. 


Paramètres de retour : (au relâchement du bouton) 


ret (in_out[0]} : si 0, une erreur existe. 
fin_x (int_out[1}) : coord. X finale de la boîte. 
fin_y (int_out{2)) : coord. Y finale de la boîte. 


graf_movebox fonction 72 


Trace une boîte en traits pointillés se déplaçant d’une position source 
à une position destination. Largeur et hauteur non modifiées. 


int ret, b_lg, boht, Sc_Xx, SC_Y, dest.x, dest_y; 


ret = graf_movebox (blg, bht, sc x; SC.y, dest.»*, dest y); 
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Paramètres d’appel : 

b_Ig (int_in[0}) : largeur de la boîte. 
b_ht (int_in[1}) : hauteur de la boîte. 
sc_x (int_in{2]) : coord. X source. 

sc_y (int_in[3]) : coord. Y source. 
dest_x (int_in{4]) : coord. X destination. 
dest_y (int_in{5]) : coord. Y destination. 


Paramètres de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


graf_growbox fonction 73 
graf_sbrinkbox fonction 74 


Trace une boîte expansive (growbox) ou rétractile (shrinkbox) donnant 
un effet visuel d'ouverture ou de fermeture (cf form_dial). 


int ret, x_pooor, y.ponor, 1.pbt, hpbt; 
int x _gcoor, y_gcoor, 1_gbt, h_gbt; 


ret = “nom de la fonction x _peour, y_peoor, 1.pbt, h_pbt, 
x_geoor, y.gcoor, 1.gbt, h_gbt); 


Paramètres d’appel : 
x_pcoor (int_in{0}) : coord. de la petite boîte. 
La source si graf_growbox, la destination si graf_shrinkbox. 
‘ y_pcoor (int_in[1}) : coord. Y de la petite boîte. 
L_pbt (int_in{2}) : largeur de petite boîte. 
h_pbt (int_in{[3]) : hauteur de petite boîte. 
x_gcoor (int_in{4]) : coord. X de la grande boîte. 
La destination si graf_growbox, la source si graf_shrinkbox. 
y_gcoor (int_in{5]) : coord, Y de la grande boîte. 
L gbt (in_in[6]) : largeur de grande boîte. 
h_gbt (int_in[7]) : hauteur de grande boîte. 


Paramètres de retour : 
ret (in_out|0}) : si 0, une erreur existe. 


graf_watchbox fonction 75 


Modifie l’état d’un objet spécifié lorsque la souris entre ou sort de la 
zone de localisation de celui-ci. L’appel à cette fonction se fait lorsque le 
bouton de souris est pressé, le retour s’effectuant au relâchement. 
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int rep, ob_quel, etat_in, etat_out; 


long adr_arb; 


rep = graf_watchbox (adr_arb, ob_quel, etat_in, etat_out); 


Paramètres d'appel : 

int_inf0]) = réservé. 

ob_quel (int_in[1]) : index de l’objet dans l’arbre. 

état_in (int_in|2}) : état de l’objet si entrée de la souris. 
état_out (int_in{3}) : état de l'objet si sortie de la souris. 
adr_arb (addr_in{0]) : adresse de l’arbre propriétaire de l’objet. 


Paramètre de retour : 
rep (int_out[0]) : position de la souris au relâchement du bouton. 
0 = en-dehors de l’objet, 1 = à l’intérieur de l’objet. 


graf_slidebox fonction 76 
Déplace un objet (une boîte) dans son objet-parent et retourne la 2c#- 
tion de enfant relativement à son parent. Permet en fait de créer son == 
pre ascenseur graphique (cf wind_get WF_HSLIDE et WF_VSLIDE). 
L'appel se fait lorsque le bouton de souris est pressé, le retour s'effes- 
tuant au relâchement. 


int rep, ob_par, ob.enf, ver _hor; 
long adr_arb; 


rep = graf.slidebox (adr_arb, eb_par, obenf, ver .hor); 


Paramètres d’appel : 
ob_par (int_in{0]) : index de l’objet parent (la cage de l’ascenseur). 
ob_enf (int_in[1}) : index de l’objet enfant (l'ascenseur). 
ver_hor (int_in{[3]) : si 0, ascenseur horizontal. 
si 1, ascenseur vertical. 
adr_arb (addr_in{0]) : adresse de l'arbre propriétaire des 2 objets. 


Paramètre de retour : 
rep (int_out{0]) : valeur entre 0 et 1 000 (cf wind_get). 


graf_handle fonction 77 


Retourne l’identificateur de la station de travail (numéro de sis 
ouverte par le Bureau GEM) ainsi que des paramètres sur les caracières. 


212 


int id sta, lg cel, ht_cel, bt_1g, bt_ht; 


id_sta = graf handle (&lg cel, &ht cel, &bt_19, Wbt_ht): 


Paramètres de retour : 

id_sta (in_out{0]) : identificateur de la station. 

lg_cel (int_out{1}) : largeur de la cellule de caractère. 

ht_cel (int_out{2]) : hauteur de la cellule de caractère. 

bt_Ig (int_out[3j) : largeur d’un carré capable d’encadrer un caractère 
bt_ht (int_out|4l) : hauteur de ce même carré. 


graf_mouse fonction 78 


Selon le drapeau spécifié, visualise, cache ou sélectionne une nouvelle 
forme de souris. 


int ret, dp.sour, sour_for [3713 


ret # graf mouse (dp_sour, sour _for); 


Paramètres d’appel : 
dp_sour (int_in{0]) : drapeau spécifiant l’action demandée. 
0 = flèche, 1 = barre verticale, 2 = abeille, 
3 = main doigt pointé, 4 = main ouverte, 5 = croix fine, 
6 = croix épaisse, 7 = croix encadrée, 
255 = souris utilisateur (forme stockée dans sour_for). 
256 = cache la souris. 
257 = visualise la souris dans sa forme courante. 
sour_for (addr_in{0]|) : adresse du tableau définissant la forme utilisateur (cf 
vsc_form dans le VDI). 


Paramètre de retour : 
ret (int_out[0}) : si 0, une erreur existe. 


graf_mkstate fonction 79 


Retourne la position de la souris, l’état des boutons et des touches SHIFT, 
CONTROL et ALTERNATE (cf evnt_button). 


int sourx, soury. etat.bs, etat cl; 


graf.nkstate {&eourx, &soury, tetat_bs, fetat cl): 


Paramètres de retour : 


sourx (int_out{1]) : coord. X de la souris. 
soury (int_out{2]) : coord. Y de la souris. 
etat_bs (int_out{3]) : état des boutons de souris. 
etat_cl (int_out{4]) : état des touches du clavier. 


Gestion des fenêtres 


wind_create fonction 100 


Alloue à l’application la taille de fenêtre spécifiée en entrée, retoirz= 
un identificateur de fenêtre. 


La taille demandée à la fonction sera la taille maximum de fenêtre (l’écre= 
plein moins la barre des menus, valeurs retournées par wind_get) si l’on va= 
donner à l’utilisateur une possibilité d’agrandissement maximum. 


Au retour, la fenêtre n’est pas ouverte (cf wind_open). 


int id_.fen, comp_.fen, x_fen, y_fens 1g_fen, ht_fen; 


id.fen = wind_create (comp_fen, «_fen, y_fen, 1g_fen, ht_fen); 


Paramètres d'appel : 


comp_fen (int_in{0}) : valeur précisant les composants de la fenêtre. 
Si le bit correspondant est mis à 1, le composant existe : 


bit 0: = NAME (0x0001) : titre de fenêtre. 

bit 1: = CLOSER (0x0002) : case de fermeture. 
bit 2: = FULLER (0x0004) : case de pleine-fenêtre. 
bit 3: = MOVER (0x0008) : barre de déplacement. 
bit 4: = INFO (0x0010) : ligne d’information. 
bit 5: = SIZER (0x0020) : case de dimensionnement. 
bit 6: = UPPARROW (0x0040) : flèche supérieure. 

bit 7:= DNARROW  (0x0080) : flèche inférieure. 

bit 8: = VSLIDE (0x0100) : ascenseur vertical. 

bit 9:= LFARROW  (0x0200) : flèche gauche. 

bit 10: = RTARROW  (0x0400) : flèche droite. 

bit 11: = HSLIDE (0x0800) : ascenseur horizontal. 


x_fen (int_in[1]) : coord. X de Ia fenêtre. 
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y_fen (int_in[2]) : coord. Y de la fenêtre. 
lg_fen (int_in[3)) : largeur de la fenêtre. 
ht_fen (int_in[4)) : hauteur de la fenêtre. 


Paramètre de retour : 

id_fen (int_out[0]) : identificateur de fenêtre (de 1 à 8, O étant Pidentifica- 
teur de la fenêtre du bureau GEM). 
Si id_fen négatif — l’AES n’a plus de fenêtre en réserve. 


wind_open fonction 101 


Ouvre une fenêtre aux coordonnées et à la taille spécifiée, fenêtre qui 
doit au préalable avoir été créée (cf wind_create). 


int ret, id_fen, x_fen, y_fen, 1g_fen, ht_fen; 


ret = wind_open tid_fen, «_fan, y_fen, lg.fen, ht_fen); 


Paramètres en entrée : 


id_fen (int_in{0]) : identificateur de la fenêtre à ouvrir. 
x_fen (int_in[1]) : coord. X de la fenêtre. 

y_fen (int_in[2]) : coord. Y de la fenêtre. 

lg_fen (int_in{3}) : largeur de la fenêtre. 

ht_fen (int_in[4) : hauteur de la fenêtre. 


Paramètre de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


wind_get fonction 104 
Retourne jusqu’à quatre information spécifiques, dont le contenu dépend 
de la valeur d’un drapeau. 


+ drapeau = 4 WF_WXYWH 

Les coord. de la zone de travail courante (fenêtre moins bordures). 
+ drapeau = 5 WF_CXYWH 

Les coord. de la fenêtre entière courante (bordures incluses). 

* drapeau = 6  WF_PXYWH 

Les coord. précédentes de la fenêtre (bordures incluses). 

+ drapeau = 7 WEF_FXYWH 

Les coord. de la plus grande fenêtre possible (bordures incluses). 

«+ drapeau = 1] WF _ FIRSTXYWH 

Les coord. du premier rectangle de retraçage 
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* drapeau = 12 WF _NEXTXYWH 
Les coord. du rectangle de retraçage suivant. 


Pour ces six valeurs de drapeau, sont retournés : 
argl = coord. X arg2 — coord. Ÿ 
arg3 = largeur fenêtre arg4 = hauteur fenêtre. 


* drapeau = 8 WF_HSLIDE 

Une valeur entre 1 et 1 000 donnant la position de l'ascenseur ko 
argl = de 1 (position gauche extrême) à 1 000 (position droîte extrê==. 
« drapeau = 9 WF_VSLIDE 

Une valeur entre 1 et 1 000 donnant la position de l’ascenseur TZ 
argi = de 1 (position haute extrême) à 1 000 (position basse extrè=. 
+ drapeau = 10 WEF_TOP 

L’identificateur de la fenêtre actuellement active. 

argl = identificateur de la fenêtre, 

« drapeau = 15 WF _HSLISIZ 

Une valeur entre 1 et 1000 donnant la taille de lascess== 
horizontal relativement à la barre de défilement. 

argl = de 1 à 1 000 (si — 1, taille minimum). 

* drapeau = 16  WF_VSLSIZ 

identique à drapeau = 15, mais pour Pascenseur vertical. 


int ret, id_fen, drap, argls arg?, argë, arg4s 


ret = wind_get (id_fen, drap, &argi, %arg?, targ£, targ4); 


Paramètres d’appel : 


id_fen (int_in{0]) : identificateur de la fenêtre. 
drap (int_in[1]) : drapeau spécifiant le type d'informations. 


Paramètres de retour : 


ret (int_out[0]) : si 0, une erreur existe. 

argl (int_out[i]) : dépendant de la valeur du drapeau. 
arg2 (int_out{2]) : dépendant de la valeur du drapeau. 
arg3 (int_out{3]) : dépendant de la valeur du dreapeau. 
arg4 (int_int{4] : dépendant de la valeur du drapeau. 


wind_set fonction 105 


Modifie un ou des contenus spécifiques, selon la valeur d’un drap. 


«* drapeau = 1 WF _KIND 
Les composants de bordure de la fenêtre. 
argi = valeur résultante des composants (cf wind_create). 
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+ drapeau = 2 WF_NAME 

L'adresse de la chaîne contenant le nom de la fenêtre. 
argl et arg2 contiennent l’adresse, 

* drapeau = 3 WF_INFO 

L'adresse de la chaîne contenant la ligne d’information. 
argl et arg2 contiennent l’adresse. 

* drapeau = 5 (cf wind_get). 

+ drapeau = 8 (cf wind get), 

* drapeau = 9 (cf wind_get). 

* drapeau = 10 (cf wind_get). 

+ drapeau = 14 WF NEWDESK 

L'adresse de l’arbre d’objets remplaçant l'arbre du Bureau GEM. 


argl = mot faible de l’adresse de l'arbre. ! 
arg2 = mot fort de l’adresse de l’arbre. ! 
arg3 = index du premier objet. 

* drapeau = 15 (cf wind_get). 


+ drapeau = 16 (cf wind_get) 


int ret, id_fen, drap, argi, arg2, arg5, arg4; : i 


ret = wind.get (id_fen, drap, argi, arg®, argÿ, arg4); 


Paramètres d'appel : Î 


id_fen (int_in{0]) : identificateur de fenêtre. 

drap (int_in{1]) : drapeau précisant la modification. 
argl (int_in{2]) : dépendant de la valeur du drapeau. ! 
arg2 (int_in[3]) : dépendant de la valeur du drapeau. 
arg3 (int_in[4)) : dépendant de la valeur du drapeau. 
arg4 (int_in{5]) : dépendant de la valeur du drapeau. i | 


Paramètres de retour : | 
ret (int_out{0]) : si 0, une erreur existe. 4 


wind_find fonction 106 
Retourne l’identificateur de la fenêtre située sous la position spécifiée. 


| 

int id_quel, sourx, soury; | 
! 

| 


id_quel = wind_find (sourx, sourÿy)s 
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Paramètres d’appel : 


sourx (int_in[0]) : coord. X du point (souvent relatif à la souris). 
soury (int_in|1l} : coord. Y du point. 


Paramètre de retour : 
id_quel (int_out|0]) : identificateur de la fenêtre sous le point. 


wind_update fonction 107 
Selon la valeur d’un drapeau, indique à l’AES que : 


+ drapeau = 0 END_UPDATE 

L'application a terminé son retraçage de fenêtre, elle débloque la lise 
des rectangles de retraçage (annule l'effet de BEG_ UPDATE). 

»* drapeau = 1 BEG UPDATE 

L'application débute une opération de retraçage, elle gèle la liste d=s 
rectangles de retraçage interdisant ainsi toute interférence. 

+ drapeau = 2 END MCTRL 

Rend le contrôle de la souris à l’AËS (annule l’effet de BEG MCTRL}. 

«* drapeau = 3 ° BEG MCTRL 

L'application prend le contrôle total de la souris : l’AES ne répond pis 
des barres de menus et de commandes. 


int ret, drap; 


ret = wind update (drap); 


Paramètre d'appel : drap (int_inlOl) : drapeau de la fonction. 
Paramètre de retour : ret (int_out| 0j) : si 0, une erreur existe. 


wind_cale fonction 108 
Retourne, d’après les composants de la fenêtre, et selon la valeur = 
drapeau : 


+ drapeau = 0 WC BORDER 

Les coordonnées de la fenêtre totale (bordures incluses) à partir des pæ=- 
mètres d'appel définissant la zone de travail. 

« drapeau = 1 WC_WORK 

Les coordonnées de la zone de travail (bordures non incluses) à DE 
des paramètres d’appel définissant la fenêtre totale. 
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int drap, comp_fen, in_x, in_y, in.19, in_ht; 
int ret, out x, out_y, aqut_1g, out _ht; 


ret = wind calc (drap, comp_fen, in_x, in_y, in_lg, incht, 
* &out-x, &out_y, $out 19, &out ht); 
Paramètres d’appel : 


drap (int_in{0]) : valeur du drapeau (0 ou 1). 

comp_fen (int_in[1]) : composants de la fenêtre {cf wind_create). 
in_x (int_in{[2]) : coord. X d’appel. 

in_y (int_in{3]) : coord. Y d’appel 

in_lg (int_in{4)) : largeur d'appel. 

in_ht (int_in[5]) : hauteur d’appel. 


Paramètres de retour : 


ret (int_out{0]) : Si 0, une erreur existe. 
out_x (int_out{1]) : coord. X de retour. 
out_y (int_out{2)) : coord. Y de retour 
out_Ig (int_out{3]) : largeur de retour, 

out ht (int_out{d]) : hauteur de retour. 


wind_close fonction 102 
Ferme une fenêtre (sans la supprimer : cf wind_delete). 


int ret, id_fen; 


ret = wind close (id_fen); 


Paramètre d'appel : id_fen (int_in[0|) : identif. de la fen. à fermer. 
Paramètre de retour : ret (int_out{0]) : si 0, une erreur existe. 


wind_delete fonction 103 
Supprime une fenêtre préalablement fermée, libère son identificateur. 


int ret, id_fen; 


ret = wind_delete (id_fen); 


Paramètre d'appel : id-fen (int_in{0]) : identif. de la fen. à supprimer. 


Paramètre de retour : ret (int_out{0]) : si O, une erreur existe. 
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Gestion des ressources 


rsrc_Jload fonction 110 
Charge un fichier ressource du disque vers la mémoire. 


int ret; 
char nom € J; 


ret = rsrc_load (nom); 


Paramètre d'appel : 
nom (addr_in|0]) : adresse de la chaîne « nom du fichier ». 


Paramètre de retour : 
ret (int_out|Ol) : si 0, une erreur existe. 


rsre_gadär fonction 112 


Fournit l'adresse d’une structure de données soit chargées par rsrc_load, 
soit stockée par rsre_saddr. 


int type, index, ret; 
long adr.rsc; 


ret = rerc_gaddr (type, index, tadr_rsc); : 


Paramètres d’appel : 


type (int_in{0]) : valeur de 0 à 16, définissant le type de structure dont on 
désire l'adresse. 


0 R TREE =structure d’arbre. 

1 R_ OBJET = structure d’objet. 

2 R_ TEDINFO = structure d’édition. 

3 R ICONBLK = structure d’icone. 

4 R_BITBLK = structure de bits. 

5 R_STRING = pointeur de chaîne. 

6 RIMAGEDATA = pointeur d’image. 

7 R_OBSPEC = pointeur dans une structure OBJECT. 
8 R_TEPTEXT = pointeur dans une structure TEDINFO 
9 R TEPTMPLT = pointeur dans une structure TEDINEO. 
10 R_ TEPVALID = pointeur dans une structure TEDINFO. 
11 R IBPMASK = pointeur dans une structure ICONBLK. 
12 R_IBPDATA = pointeur dans une structure ICONBLK. 
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13 R_IBPTEXT 
14 R_BIPDATA 


pointeur dans une structure ICONBLK, 
pointeur dans une structure BITBLK. 
15 R_FRSTR adresse d’un pointeur de chaîne, 
16 R_FRIMG adresse d’un pointeur d’image. 
index (int_in[1}) : index de l’objet. 


WU Oü M 


Paramètre de retour : 
ret (int_out{0]) : si 0, une erreur existe. 
adr_rsc (addr_out{0}) : adresse de la structure désirée, À 


rsre_saddr fonction 113 
Stocke l’adresse d’une structure de données en mémoire. 


int ret, type, index; > 
long adr _rsc, 


ret = rerc saddr (type, index, adr.rsc); 


Paramètres d'appel : ! 
type (int_in{0]) : valeur de 0 à 16 (cf. rsrc_gaddr). l 
index (int_in[1]) : index de l’objet, 

adr_rsc (addr_in{0]) : adresse de stockage de la structure. 
Paramètre de retour : |: 
ret (int_out{0]) : si 0, une erreur existe. 


rsrc_obfix fonction 114 


Convertir les coordonnées et la taille d’un objet, d’une référence de taille 
de caractères en référence de pixels. 


int index; 
long adr _arb; 


rsrc_obfix (adr_arb, index); 
Paramètres d'appel : 


index (int_in[0!) : index de l’objet à transformer. 
adr_arb (addr_in{0') : adresse de l’arbre propriétaire de l’objet, 


rsrc_free fonction 111 
Libère l’espace mémoire alloué par rsrc_load, | 
int ret; 


ret = rsrc free (€ ); 
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Paramètre de retour : 
ret (int_outf0]) : si 0, une erreur existe. 


Gestion des communications 


shel_ read fonction 120 


Permet de lire les commandes fournies par l'utilisateur au lancement 
de l'application. 


char cmd_tp [1281, arg_tp C1293; 


shel_read (emd_tp; arg tp); 


Paramètres d’appel : 


emd_tp (addr_in[0]) : adresse du tampon qui contiendra la commande. 
(nom du disque, nom du fichier, etc). 

arg_tp (addr_in[1]) : adresse du tampon qui contiendra les arguments de la 
commande. 


shel_ write fonction 121 
Enchaîne une nouvelle application. 


int dp_suites dp.graf, dp.uen; 
char cmdtp (1281, arg_tp [128]; 


shel write (dp_suite, dp.grafs dp.gens emd tps arg_tp?; 


Paramètres d’appel : 
dp_suite (int_in{0]) : drapeau de chaînage. 
0 = retour au système, 1 = chaînage d’application. 
dp_graf (int_in[1l) : drapeau graphique. 
0 = l’application à chaîner n'est pas graphique, 1 = elle l’est. 
dp_gem (int_in[2)) : drapeau GEM. 


en 


0 = l'application à chaîner n’est pas GEM, 1 = elle l'est, 
cmd_tp (addr_in{0|) : adresse du tampon de la commande à exécuter. 


arg_tp (addr_in[1l) : adresse du tampon des arguments de la commande. 
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shel_find fonction 124 


Lit sur disque et retourne des informations sur le fichier spécifié (cf trap 
1, fonction $4E), 5 étant l’attribut de recherche de la fonction (cf trap I, 
fonction $43). 


int ret; 
char sh_tp [64]; 


ret = shel_find (sh_tp}; 


Paramètre d‘appel : 


sh_tp (addr_in[0]) : adresse du tampon qui contient 
en entrée : le nom du fichier cherché. 
au retour : le bloc d’informations sur le fichier. 


Paramètres de retour : 
ret (int_out{0]) : si 0, une erreur existe. 


shel_envrn fonction 125 
Cherche une chaîne dans le tampon-système de l’AES. 


char chaine €]; 
long adr_car; 


shelenvr (adr car, chaine): 


Paramètres d’appel : 

adr_car (addr_in|0]) : adresse où sera stockée par la routine l’adresse du 
caractère nul suivant la chaîne trouvée, 

chaîne (addr_in{1|) : adresse du nom de la chaîne à chercher. 


shel_get fonction 122 


Lit en mémoire le fichier DESKTOP.INF , fichier chargé par le système 
et contenant tous les paramètres d’affichage du Bureau (emplacement des 
icones, taille et localisation des fenêtres, etc..), C’est ce fichier qui est placé 
sur disque lors d’une sauvegarde de Bureau. 


int ret, nb oc; 
char tp_lu Cnb_oc]s 


ret = shel get (tp_lu, nb_oc): 
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Paramètres d’appel : 


nb_oc (int_in[0]) : nombre d’octets à lire. 
tp_lu (addr_in|0|) : adresse du tampon de stockage. 


Paramètres de retour : 
ret (int_out|0]) : si 0, une erreur existe. 


shel_put fonction 123 


Écrit dans le tampon réservé au fichier DESKTOP.INF (cf ci-dessus}, 
permettant ainsi de modifier la disposition du Bureau lors d’un retour ä 
celui-ci. 


int ret, nb_oc; 
char tp_ecr Cnb_oci; 


ret = shel_put (tp_ecrs nb_oc); 


Paramètres d’appel : 
nb_oc (int_in{@l) : nombre d’octets à écrire. 
tp_ecr (addr_in[0]) : adresse du tampon d’écriture. 


Paramètre de retour : 
ret (int_out{0}) : si 0, une erreur existe, 


Gestion du sélecteur de fichier 


L’AES dispose d’une fonction très complète de sélecteur de fichier per- 
mettant l'affichage du répertoire d’un disque et la sélection d’un de ses fichiers. 


Les arguments fournis par le programmeur définissent l'affichage Be 
défaut ainsi que la sélection par défaut à l’entrée de la fonction. 


Mais L'AES n’empêche nullement l'utilisateur de modifier les param*- 
tres du répertoire et donc d’avoir accès à une autre unité de disquette OUË 
d’autres types de fichiers. 


A l'entrée de la fonction, s’ouvre une boîte de dialogue disposant d’u== 
fenêtre d’affichage avec ascenseur graphique, de deux boutons de sortie, = 
de deux champs d'édition qu’il nous faut détailler. 

© Le premier (actif à l’ouverture du dialogue) permet à l'utilisateur de tan 


au clavier le nom du fichier à sélectionner. Si ce dernier existe déjà, cligcæ 
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sur le nom existant place ce nom sur le champ de sélection. Double-cliquer 
sélectionne directement le fichier sans avoir à valider le bouton de sortie 
« OK ». 


Le deuxième champ (que l’on rend actif en cliquant sur la ligne ou en 
appuyant sur la flèche haute de direction) correspond au type de répertoire, 
que l’utilisateur peut modifier en remplaçant le message préexistant (par la 
commande CPM de son choix) puis en cliquant dans la fenêtre d’affichage. 


Exemple : A: xx affiche tous les fichiers du disque A. 
B:+.E?? affiche tout fichier du disque B dont l’appendice 
commence par la lettre E. 


fsel_input fonction 90 
Cette fonction nécessite ur minimum de quatre Ko pour fonctionner : 
pensez-y lors de vos réservations de mémoire. 


L'appel se fait en fournissant deux adresses de chaîne dont le contenu, 
en ASCII, spécifie les champs d’édition par défaut (si aucun nom de fichier 
par défaut, la chaîne tp_fich est vide). Au retour, ces chaînes contiennent 
la sélection de l’utilisateur, 


int ret, bt_sel; 
char tp type LI, tp_fich El; 


ret = fsel_input (tp_type, tp.fich, &bt_ sel); 


Paramètres d'appel : 


tp_type (addr_in|0}) : adresse du type de fichier par défaut. 
tp_fich (addr_in[1}) : adresse du nom de fichier par défaut. 


Paramètres de retour : 


ret (int_out|0]) : si O, une erreur existe. 
bt_sel (int_out|1}} : le bouton sélectionné par l’utilisateur. 
0 = annuler, 1 = OK. 


Gestion du « presse-papiers » 


scrp_write fonction 80 


Copie le nom d’un fichier dans un tampon spécifique, non affecté à la 
sortie de l'application. Permet à différentes applications de se communiquer 
des fichiers par l'intermédiaire du disque. 
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int ret: 
long adr.fich; 


ret = scrp_write (adr_fich); 


Paramètre d’appel : adr_fich (addr_in|0}) : adresse du nom de fichier 
Paramètre de retour : ret (int_out{0]) : si 0, une erreur existe 


serp_read fonction 80 


Lit le nom du fichier stocké dans un tampon par une autre application 
(cf scrp_write). 


int ret} 
jong adr.fich; 


ret = scrp_read (adr _fich); 


Paramètre d’appel : adr_fich (addr_in{0]) : adresse où doit être stocké = 
nom contenu dans le tampon 


Paramètre de retour : ret (int_out[0]) : si 0, une erreur existe. 
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ANNEXE 3 
CARTE MÉMOIRE | 


Prétendre établir une carte mémoire détaillée pour les 520 ST serait mal. 
honnête pour plusieurs raisons : j 


1) Le système d’exploitation, encore résident en mémoire vive à l’heure où 
est écrit ce livre, devrait être implanté en mémoire morte lorsque ce même 
ouvrage sera imprimé. 

2) Le 68000 possède des modes d’adressage permettant l’allocation dyna- 
mique des mémoires et la relogeabilité des programmes. Ces deux possibili- 
tés sont exploitées sur le ST et font de la mémoire vive utilisateur une zone 
en continuelle évolution. 


Plusieurs grandes zones peuvent cependant être définies, sinon délimi- i 
tées, qui autorisent la carte schématique suivante : 


0 
$400 Vecteurs d'interruption 68000 et 68901 
Variables système 

Mémoire disponible pour | 
l'utilisateur (actuellement 
en partie occupée par le 

$78000 système d'exploitation 

(8 FBO00 "| 

[ 

RoUr 1e 1940) zone de base de la mémoire d'écran 


7 FFFF 
($ FFFFF 
pour le 1040) 
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La mémoire morte adressable par le ST peut être divisée en deux zones : 


de $FA0000 à $FBFFFF : 128 Ko réserves à la cartouche ROM 

de $FCO000 à $FEFFFF : 192 Ko, dans lesquels doit être placé le système 
d'exploitation. D’ores et déjà 64 Ko, de $FC0000 à SFCFFFF, servent 
au démarrage du ST. 


Certaines adresses, dans la zone mémoire s'étendant de $FF8000 à 
SFFFFFF, correspondent à des circuits périphériques (rappelons que $SFFFFFF 
représente la plus haute mémoire adressable par le 68000). Ces adresses et 
celles des variables système en début de RAM constituent les seules bases 
réellement sûres pour un adressage absolu, Ces bases, bien que fort restrein- 
tes, ouvrent toutefois des possibilités étendues, justifiant à notre sens l'étude 
exhaustive ci-dessous. 


Variables système 


Les adresses allant de 0 à $FF sont réservées aux vecteurs d’interrup- 
tion 68000 tandis que les adresses allant de $100 à $1FF sont réservées aux 
vecteurs d'interruption 68901 (cf. chapitre 5). La zone s’étendant de $200 
à $3FF est théoriquement réservée à l'utilisateur. En fait, les mémoires 5380 
à S3EF servent au système de tampon de stockage lors d’une ‘‘erreur fatale” 
(erreur bus, erreur d’adresse…). Les variables système dont l'adresse est garan- 
tie immuable dans les versions ultérieures du TOS sont assez peu nombreu- 
ses puisqu'elles vont de $400 à $502. Au-delà de cette adresse, d’autres varia- 
bles sont utilisables (par exemple les tampons d'entrée série ou clavier) mais 
leur adresse ne peut être connue que par le biais de variables fixes (qui cons- 
tituent des pointeurs) ou de Traps (voir TRAP 14, fonctions $2, $10 et 522). 


Dans la table suivante, figure d’abord l'adresse de la variable (et sa lon- 
gueur codée .L pour un long mot, .W pour un mot et..B pour un octet) puis 
sa signification. 


$400.L pointeur vers la routine de traitement des interruptions ‘‘timer”. 
$404.L pointeur vers la routine de traitement des erreurs fatales (renvoie 
_ 1 dans DO pour ja routine système). 


$408L. pointeur vers la routine de fin de programme (RTS pour la routine 


système). 
$40C.L à $4iF Cinq pointeurs longs de routines réservés au GEMDOS, 
inutilisés dans la version actuelle. 
$420L. contient le nombre $7 52019F3 si le contrôle des mémoires s’est bien 
effectué au Reset du système. 
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$424.B 
$426.L 
$42A.L 
$42E.L 
$432.L 
$436.L 


$43A.L 


configuration de l’espace mémoire (0 si 128Ko, 4 si 520 Ko, 5 si 
1Mo). 

contient le nombre $31415926 dans les versions du TOS. antérieu- 
res au 20/11/85. Contient 0 depuis. Inutilisé. 

pointeur vers la routine de réinitialisation du système dans les ver- 
sions du TOS antérieurs au 20/11/85. 

haut physique de la RAM ($80000 pour un 520 ST). 

bas de la mémoire vive disponible à l'utilisateur. 

haut de la mémoire vive disponible à l'utilisateur ($78000 sur le 520 
ST, coïncide avec le début de la zone écran). 

contient le nombre $237698AA si le contrôle des mémoires s’est bien 
effectué au Reset (complément de $420.L). 


$43E.W drapeau de verrouillage de lecteur (à 1 si verrouillé). 


$440.W 
$442.W 
$444.W 


$446.W 
$448.W 


période de recherche sur disque (0 = 6 ms, 1 = 12 ms, 2 = 2 ms, 
3 = 3 ms). La période par défaut est de 3 ms. 

période du ‘‘timer””, fixée à $14 pour une fréquence d'interruption 
timer de 50 Hz. 

drapeau de vérification des écritures sur disque (validé à une valeur 
non nulle). Drapeau validé par défaut, 

numéro du périphérique d’initialisation (0 si disque A). 

mode de sortie vidéo (0 si NTSC, sinon PAL), Inutilisé. 


$44A.W inutilisé. 
$44C.W résolution vidéo courante (2 si monochrome, 1 si moyenne résolu- 


$44E.L 
$452.W 


$454.W 
$456.L 
S4SA.L 


$45E.L 


$462.L 


$466.L 


$46A.L 
$46E.L 


tion, O si basse résolution). 

adresse bas mémoire écran. 

drapeau d’autorisation de traitement des interruptions de rafraî- 
chissement d’écran (0=interdit, 1 = autorisé). 

nombre de vecteurs de la liste utilisée lors des interruptions fréquence 
de trame (voir ci-dessous). 

pointeur vers la liste des adresses des routines à exécuter lors d’inter- 
ruptions fréquence de trame (pointe en principe $4CE). 
pointeur vers la liste des 16 mots à charger dans la palette des cou- 
leurs (cf. 1.1,3), Si nul, palette système valide. 

pointeur vers une nouvelle base de mémoire d’écran à valider lors 
de l’interruption fréquence de trame suivante, Si nul, base de la 
mémoire écran inchangée, 

compteur d’interruptions fréquence de trame prises en compte (incre- 
menté 70 fois par seconde en monochrome, 60 fois avec un moni- 
teur couleurs). 

compteur global d’interruptions rafraîchissement d'écran (y com- 
pris celles qui n’ont pas été validées). 

pointeur vers la routine d’initialisation du disque dur. 

pointeur vers la routine d’info, sur état du disque dur. 
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$472.L pointeur vers la routine retournant le descripteur du disque dus. 

$476.L pointeur vers la routine de lecture/écriture sur disque dur. 

$47A.L pointeur vers la routine d’initialisation du disque dur. 

$47E.L pointeur vers la routine retournant le code de changement de dis- 
que dur (cf. Trap 13, fonction $9). 

$482.W Non nul si le secteur “boot” du disque a réclamé l'initialisation 
d’un “‘COMMAND.PRG”, nul sinon. 

$484.B Attributs du clavier (bit O à 1 : touches sonores ; bit 1 à 1 : auro- 
répétition validée ; bit 2 à 1 : sonnerie validée). 

$486.L et S48A.L vecteurs de sauvegarde (inutilisés). 

$48E à $49D zone de stockage du tampon de mémoire MD (cf. Trap 13, 0)- 

(S48E.L : 0, $492.L : adresse de départ de la mémoire libre, 
$496.L : nombre d’octets libres, $49A.L : O). 

$49E.W utilisé pour le tampon MD par le secteur “‘boot’?. 

$4AO.W comme $49E.W (voir $48E pour tampon MD). 

$4A2.L pointeur vers la zone de sauvegarde des registres du 68000 lors de 
TRAP 13 et TRAP 14. 

$4A6.W nombre de lecteurs de disquettes initialisés (0, 1 ou 2). 

$4A8.L pointeur vers la routine de sortie écran. 

$4AC.W code ASCII de la dernière touche appuyée (pour auto-rep.). 

$4B2.L pointeur vers un tampon descripteur du disque A. 

$S4B6.L pointeur vers un tampon descripteur du disque B. 

$4BA.L compteur d’interruptions horloge, incrementé 200 fois par seconé= 
(base du nombre aléatoire). 

$S4BE.L inutilisé (réservé). 

$4C2.L carte mémoire des lecteurs actifs (bit O0 à 1 si disque À actif, bit 2 
à 1 si disque B actif, etc). 

$4C6.L pointeur vers le tampon général de stockage des données d’un dis- 
que (stockage du secteur “boot’”). 

$4CA.L pointeur vers la routine d’auto-exécution (placé par le ‘‘boot’? ses- 
teur). Nul si pas de routine. 

$4CE.L à SEAL huit adresses de routines exécutables lors d’interruptiozs. 
rafraîchissement écran (chacune des routines est exécutée sUCCESÉ- 
vement. Une adresse nulle constitue la fin de la liste. 

$4EE.W drapeau de copie d'écran (1 si en cours, — 1 si interdite). 

$4FO.W inutilisé. 

$4F2.L pointeur vers l'adresse de départ du TOS (pointe la routine de dép 
chaud du système). 

$4F6.L pointeur vers le bloc d'informations du “‘shell”?. 

$4FA.L pointeur vers le début de la mémoire disponible. 

$4FE.L pointeur vers le début du GEM AËES. 

$502.L adresse de la routine de copie d'écran. 
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Les adresses dédiées à des périphériques sont décrites dans les pages qui 
suivent. Certaines de ces adresses correspondent à des registres ne pouvant 
qu'être lus, d’autres à des registres pouvant être lus ou écrits (d’où le codage 
L, R ou R/L). Toute opération sur ces mémoires, court-circuitant le système 
d’exploitation, doit être effectuée avec un soin extrême, les risques de ‘‘plan- 
ter’* le système étant important. 


Contrôleur de mémoire : 
SFF8001.B indique la taille de la mémoire (0 : 128 Ko, 4 : 512 Ko). 


Contrôleur vidéo : 

$FF8201.B base haute de la mémoire d’écran (multiple de 64 Ko). 

$FF8203.B base basse de la mémoire d’écran (multiple de 256 octets) base 
de la mémoire d’écran = 65536 + (SFF8201) + 256 x (FFF8203). 

$FF820A.B mode de synchronisation vidéo (2 si Pal, 0 sinon). 

SFEF8240 à SFF825F 16 mots correspondant à la palette de couleurs. 

SFF8260.B les bits 0 et 1 définissent la résolution de l’écran (2 si haute, 
1 si moyenne, 0 si base). 


Les adresses $FF8205, $FF8207, SFF8209, SFF820B, $FF820D, $FF820F 
et $FF8261 à $FF827F correspondent à des registres du contrôleur vidéo et 
permettent différentes manipulations de celui-ci. Leur utilisation est 
déconseillé. 


Contrôleur de disque et de DMA (accès direct à la mémoire) 
$SFF8604.B accès aux données du contrôleur de disque. 
$FF8606.B contrôle de mode DMA. 
$SFF8609.B base haute du DMA. 
$FF860B.B base moyenne du DMA. 
$SFF860D.B base basse du DMA. 


Synthétiseur de son : 


SFF8800.B sélection de registre du circuit son et registre de données en lec- 
ture du circuit son. 
$SFF8802.B registre de données en écriture du circuit son. 


Les mémoires $FF8800 à SFF88FF peuvent être lues ou écrites. 


Périphérique multi-fonctions 68901 


$SFFFAO1.B registre général d’entrée-sortie des données. 
$SFFFAO03.B registre de sélection du front actif. 
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SFFFAO5.B registre de direction des données. 

$SFFFA07.B registre de validation des interruptions (A). 
SFFFAO9.B registre de validation des interruptions (B). 
SFFFAOB.B registre d’interruptions en attente de service (A). 
$FFFAOD.B registre d’interruptions en attente de service (B). 
$FFFAOF.B registre d’interruptions en Cours de service (A). 
$SFFFA11.B registre d’interruptions en COUrs de service (B). 
SFFFA13.B registre de masque des interruptions (A). 
SFFFA15.B registre de masque des interruptions (B). 
$SFFFA17.B registre vecteur (bit 3 : mode, bits 4 à 7 : numéro). 
SFFFA19.B registre de contrôle du timer A. 

$SFFFAIB.B registre de contrôle du timer B. 

SFFFAID.B registre de contrôle des timers C et D. 
SFFFAIF.B registre de données du timer A. 

$EFFA21.B registre de données du timer B. 

SFFFA23.B registre de données du timer C. 

SFFFA25.B registre de données du timer D. 

SFFFA27.B registre de caractère de synchronisation. 
$FFFA29.B registre de contrôle général de l’E/S série. 
SFFFA2B.B registre d’état du récepteur série. 

$FFFA2D.B registre d'état de l'émetteur série. 

$SFFFA2E.B registre de données de PE/S série, 


Circuit ACJA clavier : 


SFFFCO0.B registre de contrôle de l’'ACIA clavier. 
SFFFCO2.B registre de données de P'ACIA clavier. 


Circuit ACIA MIDI : 


$FFFCO6.B registre de contrôle de l’'ACTA MIDI. 
SFFFCO8.B registre de données de PACIA MIDI. 


ANNEXE 4 
TRAPS 


Tout appel de Trap, qu’il soit fait en assembleur ou en C, nécessite un 
ou plusieurs paramètres d’appel, le paramètre minimum étant le numéro de 
la fonction Trap appelée. Ces paramètres sont placés dans la pile avant l'appel 
selon le schéma suivant : 


numéro de la fonction 


haut de la 
mémoire 


premier paramètre 


deuxième paramètre 


etc. 
où chaque case correspond à un mot, soit 2 octets, 


Un paramètre de retour entier est toujours renvoyé dans DO. Certaines 
fonctions renvoient un paramètre long (noté DO.L dans les tâbleaux suivants). 
Lorsque d’autres paramètres de retour sont nécessaires, ils sont retournés 
par le biais de pointeurs dont les adresses ont été fournies parmi les paramè- 
tres d'appel. 


Pour appeler‘un Trap en C, deux méthodes sont utilisables : 


1) <paramètre de retour> = <nom de fonction (<1% paramètre>, <2e 
paramètre>, etc...) 
exemple : a = Bconstat (2) exécute Trap 13, avec 1 pour numéro de 
fonction et 2 comme 1®r et seul paramètre, a est le paramètre 
de retour (ici l’état des entrées clavier). 
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2) <paramètre de retour > = <nom du Trap> (<numéro de fonction>. 
<i+ paramètre>, <2° paramètre>, etc...) 
exemple : a = bios (1,2) exécute Trap 13, avec:i pour numéro de fozz 
tion et 2 comme paramètre (identique à ci-dessus). 


Selon le compilateur C utilisé, les noms de Traps et les noms de farz- 
tions système peuvent être différents. Avec le compilateur Digital Research, 
les Traps ont les noms suivants : 


TRAP i : gemdos 
TRAP 13 : bios 
TRAP 14 : xbios 


Les noms de fonctions C correspondant à chacune des fonctions systè= 
sont fournis dans les tableaux qui suivent. 


On notera que TRAP 2 n’a pas de nom en C, ce qui s'explique par le 
non implémentation des fonctions CP/M par le biais de Trap 2. Toutes Es 
fonctions VDI et AËES sont appelées par l'intermédiaire d’un Trap 2, mes 
leur appel se fait par le nom de fonction VDI ou AES (cf. Annexe 2). les 
envisageable, en assembleur d'utiliser Trap 2 pour un appel de fonction GEM 
(cf. 3.1.3. pour une explication détaillée de la procédure à mettre en ŒUVTE). 
Deux autres fonctions sont disponibles par Trap 2 en assembleur, elles sozt 
étudiées dans cette annexe. 


Une extrême vigilance s'impose quant à la longueur (mot ou long mo) 
des paramètres d’appel ou de retour des fonctions système. En effet, la p— 
part des compilateurs ne retournent pas de code erreur si l’on utilise un paz- 
mètre long à la place d’un paramètre court et réciproquement. Bien souve==. 
le résultat à l’exécution est catastrophique ! Il est cependant possible d'u 
ser en C une variable entière pour stocker un paramètre de retour lons 
les deux octets inférieurs du paramètre de retour suffisent (exemple : Cez- 
nin() qui renvoie une entrée clavier, dont on peut négliger le mot for). ju 
est également possible de ne pas employer de paramètre de retour du 10 
si l’on décide de ne pas en tenir compte, surtout lorsque ce paramètre 
un simple code d'erreur (exemple : Tsettime (< heure >} peut être appelé a 
en C, si l’on est certain que l'heure fournie est correctement formatée). 


Avec TRAP 1 et TRAP 2, seul le registtre DO est modifié durant l’exs- 
cution du Trap (il contient le paramètre de retour). Tous les autres regisires 
reviennent inchangés, sauf pour Trap 1 fonction $20 (passage d’un mois 
à un autre) dans lequel DO, DI et A7 sont modifiés. 


Avec TRAP 13 et TRAP id, les registres DO à D2 et AO à A2 peuvez 
être modifiés durant l’exécution du Trap. Par contre les registres D3 à D 
et A3 à A7 sont inchangés. 
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TRAP 1 


TRAP 1 fonction 0 : PtermO() TER 


Termine le programme en cours (cf Trap 1, fonction $4C) 
paramètres d'appel : aucun 
paramètre de retour : toujours nul 


TRAP 1 fonction 1 : Cconin () CONIN 
Lit un caractère entré au clavier et l'affiche à l’écran 
paramètres d’appel : aucun 
paramètre de retour : (long) caractère entré au clavier 
Remarque : Le caractère est retourné sous la forme d’un long mot ayant 
la structure suivante : 00 <code clavier> 00 <code ASCII> ou le code 
clavier dépend de la touche appuyée : 


code touche code touche code touche code touche 


01 Esc 19 . P 31 N 4E + (pave} 
02 1 1A A 32 * 50 fl, bas 
03 2 18 $ 33 h 52 Insert 
04 3 1C Return 34 } 53 Delete 
05 4 1D Control 35 = 60 < 
06 5 1E Q 86 Shift (d) 61 Undo 
07 6 1F S 88 Alternate 62 Help 
08 7 20 D 39 Espace 63 { (pavé) 
09 8 21 F 3A Capslock 64 } (pavé) 
OA 8 22 G 3B F1 65 1 (pavé) 
0B (o) 23 H Ke F2 66 * (pavé) 
OC } 24 J 8D F3 67 7 (pavé) 
OD _ 25 K 8E F4 68 8 (pavé) 
OE  Backspace 26 L 3F F5 69 9 (pavé) 
OF Tab 27 M 40 F6 6A 4 (pavé) 
10 A 28 % 4 F7 6B 5 (pavé) 
11 VA 29 d 42 F8 6C 6 (pavé) 
12 E 2A Shift(g) 43 F8 6D 1 (pavé) 
13 R ° 2B # 44 F10 6E 2 (pavé) 
14 T 2C W 47 Home 6F 3 (pavé) 
15 Ÿ 2D X 48 flhaut 70 © (pavé) 
16 U 2E C 4A — {pavé) 71 . (pavé) 
17 | 2F v 4B fl.gauche 72  Enter(pavé) 
18 [e] 30 B 4D fl.droite 


Le retour de la fonction Cconin (1) ne s’effectue que lorsqu’une touche 
du clavier a été pressée (sauf Shift, Control, Alternate et Capslock, qui ne 
provoquent pas un retour de fonction). 


TRAP 1 fonction 2 : Cconout (a) CON OUT 
Affiche un caractère à l'écran 
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paramètres d’appel : (mot) caractère à afficher 
paramètre de retour : aucun 


L’octet faible du paramètre d’appel correspond au code ASCII du caree- 
tère à afficher, l’octet fort doit être nul. 


TRAP 1 fonction 3 : Cauxin () AUXIN 
Lit un caractère sur l’entrée série RS 232 


paramètres d'appel : aucun 
paramètre de retour : (long) caractère lu 


Le retour de cette fonction ne s’effectue que lorsqu'un caractère 2 &£ 
reçu sur l’entrée série, Ce caractère est retourné dans l’octet faible de DO. 


TRAP 1 fonction 4 : Cauxout (a) AUKOÛUT 
Écrit un caractère sur la sortie série RS 232 


paramètres d’appel : (mot) caractère à envoyer 
paramètre de retour : aucun 


Le caractère est placé dans l’octet faible, L’octet fort doit être nul. 


TRAP 1 fonction 5 : Cprnout (a) PRTOUT 
Écrit un caractère sur la sortie parallèle, 


paramètres d'appel : (mot) caractère à envoyer 
paramètre de retour : (long) —1 si envoi correct, 0 sinon 


Le caractère est placé dans l’octet faible. L’octet fort doit être nul. & 
l’imprimante n’est pas connectée ou si la ligne Busy reste active durarz 
30 secondes, un retour de fonction s'effectue avec DO.L = 0. 


TRAP 1 fonction 6 : Crawio (a) RAUU CO N 10 
Lecture d’une entrée clavier brute ou affichage 


paramètres d’appel : (mot) type d’entrée-sortie demandée 

si (—1) lit une entrée clavier 

sinon affiche le paramètre d’appel à l'écran 
paramètre de retour : (mot) entrée clavier si par. d'appel = —1 


Si le paramètre d’appel est égal à — 1 (demande d’entrée clavier), le rez 
de fonction s'effectue avec le caractère lu dans le tampon clavier ou 0 si auc— 
caractère n’est dans ce tampon. Le retour est donc immédiat et le caracèe 
n'est pas affiché à l’écran (pas d’écho). 
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TRAP 1 fonction 7 : Crawcin () CONIN UE 
Lecture d’une entrée clavier brute (sans écho) 


paramètres d’appel : aucun 
paramètre de retour : (long) caractère lu au clavier 


Le caractère lu au clavier est retourné selon la même structure que pour 
la fonction Cconin (page précédente), Le caractère n’est pas affiché à l’écran 
(pas d’écho). Le retour de la fonction ne s'effectue qu'après une entrée clavier. 


TRAP1 fonction 8 : Cnecin () 
Lecture d’une entrée clavier sans écho. 


paramètres d’appel : aucun 
paramètre de retour : (long) caractère lu au clavier 


Le caractère lu au clavier est retourné selon la même structure que pour 
la fonction Cconin et non affiché. Les codes de contrôle, A C, AQ etAS sont 
interprêtés (sortie du programme, reprise et arrêt d’affichage) et ne provo- 
quent pas un retour de la fonction. 


TRAP 1 fonction 9 : Cconws (a) PRINT LINE 
Affichage d’une chaine à l'écran 


paramètres d’appel : (long) adresse de la chaine à afficher 
paramètre de retour : aucun 


La chaîne à afficher est envoyée caractère par caractère. Le dernier carac- 
tère de la chaîne doit être suivi d’un caractère nul (00). Chaque caractère 
de la chaîne doit être codé sur un octet. 


TRAP 1 fonction $A : Cconrs (a) READ LINE 
Lecture d’une chaîne entrée au clavier 


paramètres d'appel : (long) adresse du tampon où stocker la chaîne 
paramètre de retour : aucun 


En entrée, le premier octet du tampon doit contenir le nombre maxi- 
mum d’octets à lire ou, par défaut, le nombre d’octets du tampon moins 
deux. En sortie, le nombre d’octets lu est indiqué dans le deuxième octet du 
tampon. À partir du troisième octet est stockée la chaîne. 


Le retour de la fonction s’effectue lorsqu’un retour de chariot est entré 
au clavier, Si le nombre maximum d’octets à lire est atteint avant un retour 
de chariot, une sonnerie (AG) résonne et les octets suivants ne sont pas pris 
en compte. Le retour de fonction s’opère au premier retour de chariot. 
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Les codes de contrôle A G,AE, AQ, AR, AS, AU, AX, le retour arrière & 
l'effacement ne provoquent pas d’entrées dans la chaîne mais sont interpré- 
tés selon leur fonction normale. 


TRAP 1 fonction $B : Cconis 0 CONSTAT 
Demande l’état du tampon clavier 
paramètres d’appel : aucun 
paramètre de retour : (mot) —1 si un caractère est disponible, 0 sinon 


TRAP 1 fonction $E : Dsetdry (a) SETD RU 
Fixe le lecteur de disque par défaut 


paramètres d’appel : (mot) numéro du disque (0 si À, 1 si B, etc.) 
paramètre de retour : (long) carte des lecteurs actifs 


La carte des lecteurs actifs renvoyée dans DO est la suivante : Le bit Q 
est à 1 si le lecteur A est actif, le bit L est à 1 si Le lecteur B est actif, etc. 
Les lecteurs C, D, .…., P suivants ne sauraïent naturellement correspondre 
qu’à des disques virtuels (cf. chapitre 3). 

TRAP 1 fonction $10 : Cconos ( CONOSTAT 

Demande l’état de l’écran 


paramètres d'appel : aucun 
paramètre de retour : (long) —1 si l’écran est prêt à recevoir un caractère, 
0 sinon 


Type même de la fonction inutile ! Retourne toujours —1 


TRAP 1 fonction $11 : Cprnos ( ) RRTOSTAS 
Demande l’état de la ligne Busy de la sortie parallèle 


paramètres d’appel : aucun 
paramètre de retour : (long) — 1 si imprimante prête, O sinon 


Type même de la fonction peu utile ! Une vérification de l’état de la 
ligne Busy est en effet effectuée dans tous les cas lors de l'écriture sur Ja sor- 
tie parallèle (cf. Cprnout, page précédente). 


TRAP 1 fonction $12 : Cauxis ( ) AXUXISTAT 
Demande l’état du tampon d’entrée série RS 232 


paramètres d'appel : aucun 
paramètre de retour : —1 si un caractère est disponible, O sinon, 
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Le 


Comme pour la fonction précédente, toute demande d’entrée série débute 
par un test d’état du tampon, répété jusqu’à ce qu’un caractère soit disponi- 
ble. La fonction Cauxis a toutefois l'intérêt de permettre de vérifier que 
l'entrée sortie série est bien reliée à un périphérique (avec une boucle de tem- 
porisation adéquate). 


TRAP1 fonction $13 : Cauxos ( ) AUX D STAT 
Demande l’état du tampon de sortie série RS 232 


paramètres d’appel : aucun 
paramètre de retour : —1 si la sortie série est prête à recevoir 0 sinon 


Retourne —1 si le tampon de sortie série n’est pas plein. 


TRAP 1 fonction $19 : Dgetdrv (a) GURDRV 
Recherche le lecteur de disque par défaut 


paramètres d’appel : aucun 
paramètre de retour : (mot) O si disque A, 1 si disque B, etc. 


cf. la fonction corollaire Dsetdrv( ), Trap 1 fonction $E. 


TRAP 1 fonction $1A : Fsetdta (a) SET DTA 
Fixe l'adresse de stockage des données sur un fichier 


paramètres d’appel : (long) adresse du tampon de stockage 
paramètre de retour : aucun 


Le tampon de stockage des données d’un fichier de disque est utilisé 
par les fonctions Fsfirst et Fsnext (Trap 1 fonctions $4E et $4F). Ce tampon 
doït comporter au minimum 44 octets. 


Un tampon de stockage par défaut est créé à l’initialisation du système. 
Son adresse peut être obtenue par Fgetdta (Trap 1, fonction $2F). 


TRAP 1 fonction $20 : Super (a) SUPER 
Changement de mode (superviseur en utilisateur, ou le contraire) 


Les paramètres d’appel et de retour de cette fonction diffèrent selon le 
mode de fonctionnement du microprocesseur 68000. 


Si l’on se trouve en mode utilisateur : 
paramètres d’appel : (long) pointeur de pile SUPERVISEUR 
ou 0 si l’on désire user du pointeur de pile supervi- 
seur système, 
paramètre de retour : ancien pointeur de pile utilisateur. 
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Si lon se trouve en mode superviseur : 


paramètres d’appel : (long) pointeur de pile UTILISATEUR 
qui doit être le paramètre de retour précédent si l’on 
est passé en superviseur par Super(a) avec un chan- 
gement de pointeur de pile superviseur. 

paramètre de retour : aucun 


Si la fonction Super est employée avec un paramètre d’appel égal à 1, 
il s’agit alors d’un test de mode. Le paramètre de retour (long) est égal à 
0 si l’on se trouve en mode UTILISATEUR et — 1 si l’on se trouve en mode 
SUPERVISEUR. 


TRAP 1 fonction $2A : Tgetdate( } GET DATE 
Demande la date 
paramètres d’appel : aucun 
paramètre de retour : (mot) date 
La date est ainsi formatée dans un mot : 


bits 0 à 4 : jour du mois (1 à 31) 
bits 5 à 8 : mois de l’année (1 à 12) 
bits 9 à 15 : année — 1980 (0 à 119 avec 1980=0 et 2099= 119) 


La date fournie n’a naturellement de sens que si la date correcte a été 
auparavant initialisée par Tsetdate ci-dessous. 


TRAP 1 fonction $2B : Tsetdate (a) SETDAE 
Fixe la date 
paramètres d’appel : (mot) date selon format ci-dessus 


paramètre de retour : —1 si le format de la date fournie est incorrect 
0 si le format de la date fournie est correct 


TRAP 1 fonction $2C : Tgettime( ) GETLTIME 
Demande l’heure 
paramètres d’appel : aucun 
paramètre de retour : heure selon le format suivant : 
bits O0 à 4 : nombre de secondes (arrondi pair) 
bits 5 à 10 : nombre de minutes 
bits 11 à 15 : nombre d’heures 


TRAP 1 fonction $2D : Tsettime (a) SéT- TINË 
Fixe l’heure 


240 


EE 


paramètres d’appel : (mot) heure selon format ci-dessus 
paramètre de retour : 
—1 si le format de l’heure fournie est invalide 
0 si le format de l’heure fournie est valide 


TRAP 1 fonction $2F : Fgetdta ( ) G ETDTA 
Demande l'adresse du tampon de stockage des données d’un fichier 


paramètres d’appel : aucun 
paramètre de retour : (long) adresse du tampon 


cf. Fsetdta, Trap 1 fonction $1A. 


TRAP 1 fonction $30 : Sversion ( ) QETVUR 


Demande le numéro de version du GEMDOS 


paramètres d’appel : aucun 
paramètre de retour : (mot) numéro de version 


L’octet faible de DO contient le numéro maître et l’octet faible le numéro 
secondaire (exemple : 0001 correspond à la version 1.00). 


Des six versions du système d’exploitation sur lesquelles a travaillé 
Vauteur de Juillet 85 à Janvier 86, deux portaient le numéro de version 0D00 
soit 0.13 et quatre le numéro 1300 soit en principe 0.19. Il est toutefois vrai- 
semblable qu’il s’agit de la même version dont le numéro a été ‘‘décimalisé”. 


TRAP 1 fonction $31 : Ptermres (a,b) HEEPPROC 
Fin d’un programme et libération de mémoire 


paramètres d’appel : (long) nombre d’octets de mémoire à libérer 
(mot) code de sortie du programme 
paramètre de retour : aucun (naturellement) 


Fonction dangereuse puisque son résultat n’est pas garanti dans les systè- 
mes d’exploitation futurs ! La libération de mémoire est étudiée dans Mshrink 
(Trap 1, fonction $44). Utiliser PtermO ou Pterm(a) (Trap 1, fonctions 0 et 
$4C) de préférence. 


TRAP 1 fonction $36 : Dfree (a,b) CAFTDFREE 
Demande d’informations sur un disque 
paramètres d’appel : (long) adresse du tampon ou stocker les info. 
(mot) numéro du disque (0 par défaut, 1 si A, 2 si 
B, etc.) 
paramètre de retour : —46.L si le disque n’est pas actif, O sinon 
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Le tampon dont l’adresse est envoyée en appel doit comporter au moins 
seize octets. Si l'adresse de départ de ce tampon est notée ”’ad”, on aura : 

ad — nombre de blocs libres sur le disque 

ad + 4 — nombre total de blocs du disque 

ad + 8 — taille d’un secteur en octets 

ad + 12 — nombre de secteurs par bloc 


Un secteur contient 512 octets : un bloc est formé de 2 secteurs, soit 
1024 octets. Le bloc est l’unité de chargement d’un fichier sur disque, c’est- 
à-dire qu’un fichier même de 10 octets occupera un minimum de 1024 octets 
sur le disque. Au formatage, 351 blocs existent sur un disque simple face 
et 711 blocs sur un disque double face (nombre retourné dans ad + 4). Mais 
l'en-tête de disque occupe dans les deux cas 2 blocs. On dispose donc de 349 
blocs réels (349 Ko) sur un disque simple face et de 709 blocs (709 Ko) sur 
un disque double face. Les titres et informations sur les programmes sont 
stockés dans l’en-tête du disque et n’appartiennent pas aux blocs. Ainsi un 
fichier de 1024 octets n’occupera qu’un bloc... tout comme un fichier de 2 
octets ! 


TRAP 1 fonction $39 : Dereate (a) US IR 
Création d’un sous-répertoire de disque 
paramètres d’appel : (long) adresse de la chaine contenant le nom 
paramètre de retour : (long) 0 si création bien effectuée 


—34L si nom de disque non trouvé 
—36L si disque non actif 


Le nom du sous-répertoire doit débuter par la lettre identifiant le dis- 
que (A, B...), en majuscule ou minuscule, suivi de ‘‘:”” et du nom du sous- 
répertoire, sauf si le disque concerné est le disque courant (cf. Dsetdrv er 
Dgetdrv), auquel les deux premiers caractères ne sont pas nécessaires. La 
chaîne doit se terminer par un caractère nul. 


TRAP 1 fonction $3A : Ddelete (a) LAB, 
Suppression d’un sous-répertoire de disque 


paramètres d'appel : (long) adresse de la chaine contenant le nom 
paramètre de retour : (long) 0 si effacement correct, négatif sinon 


Supprime un sous-répertoire créé par la fonction ci-dessus. 


TRAP 1 fonction $3B : Dsetpath (a) CH DIR 
Fixe le répertoire courant d’un disque 
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paramètres d’appel : (long) adresse de la chaîne contenant le nom 
paramètre de retour : (long) 0 si création correcte, négatif sinon 


Le nom du répertoire doit être contenu dans une chaîne terminée par 
un caractère nul. Les notes afférentes à Dcreate (Trap 1, fonction $39) sont 
également applicables à Dsetpath. 


TRAP 1 fonction $3C : Fcreate (a,b) CREATE 
Création d’un fichier sur disque 


paramètres d’appel : (long) adresse de la chaîne contenant le nom 
(mot) type du fichier créé : 
00 fichier normal 
01 fichier ne pouvant qu'être lu 
02 fichier transparent au répertoire 
04 fichier système, transparent au répertoire 
08 fichier contenant un nom dans les 11 premiers 
octets 

paramètre de retour : (long) négatif si création non effectuée 
identificateur du fichier si création faite 


La chaîne contenant le nom du fichier doit commencer par la lettre iden- 
tifiant le disque (A, B...) et le symbole ‘‘:”” puis le nom de répertoire et le 
nom de fichier, un caractère nul terminant la chaîne, La non création d’un 
fichier peut résulter du manque d’espace dans le répertoire, de l’impossibi- 
lité d’accéder au disque ou de l’existence du fichier à créer. 


Un fichier non existant doit toujours être créé mais cette création fait 
office d'ouverture. 


TRAP 1 fonction $3D : Fopen. (a,b) ®eP&N 
Ouverture d’un fichier existant sur disque 


paramètres d'appel : (long) adresse de la chaîne contenant le nom (mot) 
type d'ouverture : 
0 : ouverture en lecture seule, 
1 : ouvert en écriture seule, 
2 : ouvert en lecture/écriture 

paramètre de retour : (long) identificateur du fichier ouvert négatif si fichier 
non ouvert. 


Il est plus que recommandé de conserver le paramètre de retour puisqu'il 
s’agit de l’identificateur du fichier, indispensable pour toute opération ulté- 
rieure sur le fichier. L’identificateur de fichier correspond au mot faible du 
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paramètre de retour. Après ouverture, le pointeur de fichier est positionné 
en début de fichier (cf Fseek). 


TRAP 1 fonction $3E : Fclose (a) CLOSE 
Fermeture d’un fichier sur disque 


paramètres d’appel : (mot) identificateur du fichier 
paramètre de retour : (long) 0 si fermeture correcte 
négatif sinon 


L’identificateur de fichier envoyé en appel correspond à l’identificateur 
renvoyé à l’ouverture du fichier. 


TRAP 1 fonction $3F : Fread (a,b,0) READ 
Lecture d’octets dans un fichier sur disque 


paramètres d’appel (mot) identificateur du fichier (cf. Fopen) 
(long) nombre d’octets à lire 
d (long) adresse du tampon de stockage 
(à 


paramètre de retour : (long) nombre d’octets lus négatif si erreur. 


Les octets sont lus dans le fichier à partir du pointeur de fichier (cf, Fseek, 
Trap 1, fonction $42). Ils sont stockés à partir de l’adresse fournie dans le 
3° paramètre d'appel. 


TRAP 1 fonction $40 : Fwrite (a,b,c) WRITE 
Écriture d’octets dans un fichier sur disque 


paramètres d'appel Y'{mot) identificateur du fichier (cf. Fopen) 
(long) nombre d’octets à écrire 
A (long) adresse du tampon de stockage 
paramètre de retour : (long) nombre d’octets écrits négatif si erreur. 


Les octets sont placés dans le fichier à partir de la position du pointeur 
de fichier (cf. Fseek, fonction $42), Ils sont lus dans le tampon dont l’adresse 
est fournie en 3° paramètre d’appel. 


TRAP 1 fonction $41 : Fdelete (a) ON LINE 
Effacement d’un fichier sur disque 
paramètres d’appel : (long) adresse de la chaîne contenant le nom 


paramètre de retour : (long) 0 si le.fichier est effacé négatif si erreur (fichier 
inexistant.) 
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La chaîne contenant le nom du fichier doit commencer par la lettre d’iden- 
tification du disque (A,B,.…) et le symbole par défaut (cf. Dsetdrv). Elle doit 
se terminer par un octet nul. 


TRAP 1 fonction $42 : Fseek (a,b,c) LSEEU 
paramètres d’appel : (long) nombre d’octets 
(mot) identificateur du fichier (cf, Fopen) 
(mot) type de pointeur de fichier 
paramètre de retour : position du pointeur de fichier par rapport au début 
de celui-ci, négatif si erreur. 


Le type de pointeur de fichier (3° paramètre d’appel) définit le type de 
positionnement désiré : 
0 : place le pointeur N octets après le début de fichier 
1 : place le pointeur N octets après la position actuelle du pointeur 
2 : place le pointeur N octets avant la fin de fichier (N négatif) 
où N est le nombre d’octets entré comme 1° paramètre d’appel. En utilisant 
Fseek (0, <id. fichier>, 2), on obtiendra en retour le nombre d’octets du 
fichier. 


TRAP 1 fonction $43 : Fattrib (a,b,c) cho 
Fixe ou demande les attributs d’un fichier 


paramètres d'appel : (long) adresse de la chaîne contenant le nom 
(mot) 0 pour demander les attributs 
1 pour fixer les attributs 
(mot) attributs à fixer (0 si demande) 
paramètre de retour : (long) attributs si demande 


Les attributs sont définis ainsi : 


01 : fichier à lecture seule 

02 : fichier transparent au répertoire 

04 : fichier système, transparent au répertoire 

08 : début de fichier correspondant au nom (11 octets) 
10 : début de fichier correspondant à un sous-répertoire 
20 : fichier écrit puis refermé 


TRAP 1 fonction $45 : Fdup (a) EUXS 
Génère une copie d’un identificateur de fichier 
paramètres d’appel : (mot) identificateur du fichier (cf. Fopen) 


paramètre de retour : (long) nouvel identificateur du fichier 
négatif si erreur 
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A un fichier déjà ouvert est affecté un second identificateur, le poin- 
teur de fichier affecté au 2° identificateur suivant les modifications affec- 
tant le pointeur affecté au 1° identificateur. Un identificateur de fichier stan- 
dard est toujours compris entre 0 et 5, alors que les doublons sont supérieurs 
ou égaux à 6. L’utilité du gemellage ainsi effectué est restreinte. 


TRAP 1 fonction $46 : Fforce (a,b) Force 


Force un identificateur standard à pointer le même fichier qu’un identi- 
ficateur de fichier non standard 


paramètres d’appel : (mot) identificateur de fichier standard 
(mot) identif. de fichier non standard 
paramètre de retour : (long) 0 si opération bien effectuée 
négatif sinon. 


TRAP 1 fonction $47 : Dgetpath (a,b)  @ËTDIR 
Demande du répertoire courant 


paramètres d’appel : (long) adresse du tampon de stockage 
(mot) 0 si disque par défaut, 
1 si disque À, 2 si disque B... 
paramètre de retour : négatif si disque non trouvé, 0 sinon. 


Le tampon de stockage doit être d’au moins 64 octets. La chaîne retournée 
ne comprend pas la lettre d’identification du disque (A, B...) ni les deux points 
et la barre inversée (\) de début de répertoire. 


TRAP 1 fonction $48 : Malloc (a) qALtoc 
Demande d’allocation mémoire 


paramètres d’appel : (long) nombre d’octets à allouer 
— 1 pour savoir le nombre d’octets disponibles 
paramètre de retour : (long) adresse de départ zone mémoire allouée ou 
nombre d’octets disponibles (si —1 à l’appel) 
0 si allocation mémoire impossible 


Une réservation mémoire s’opère habituellement en deux phases : 


1) demande du nombre d’octets disponibles (Malloc (—1)), 
2) réservation par : adresse = Malloc (<nombre d’octets>). 


Il est déconseillé de réserver toute la mémoire disponible, certaines fonc- 
tions GEM (comme fsel_input) ayant besoin d'effectuer des allocations 
mémoire temporaires (laisser au moins 3 Ko en réserve). Le nombre d’octets 
alloués est toujours pair (arrondi supérieur). 


246 


TRAP 1 fonction $49  : Mfree (a) FREE 
Libération de mémoire allouée précédemment 


paramètres d’appel : (long) adresse de départ de la’ zone allouée 
paramètre de retour : (long) 0 si mémoire libérée, négatif si erreur 


Cette fonction doit être utilisée avant sortie d’un programme ou une 
zone mémoire a été allouée par Malloc (cf. ci-dessus). 


TRAP 1 fonction $4A : Mshrink (a,b) SET BLOC 
Libération de mémoire au profit du système 


paramètres d’appel : (mot) 0 (réservé pour le système) 
(long) adresse de base de la zone à libérer 
(long) nombre d’octets à libérer 
paramètre de retour : 0 si libération effectuée, 
négatif sinon 


Cette fonction sert à réaffecter une zone mémoire du programme du 
système. En fait, le prologue de tout programme compilé et “‘lié”’ contient 
cette fonction (ajoutée par le compilateur). Tout programme démarre donc 
avec la taille mémoire juste nécessaire au code objet, aux données et à la 
pile. L'intérêt de cette fonction réside dans le fait qu’elle permet de rendre 
au système une part d’une zone mémoire préalablement réservée par Malloc. 


TRAP 1 fonction $4B : Pexec (a,b,c,d) E*éc 
Charge et exécute un programme 


paramètres d’appel : (mot) O pour chargement et exécution 
3 pour chargement sans exécution 
(long) adresse de Ja chaîne contenant le nom 
(long) adresse d’un jeu de commandes 
(long) adresse des chaînes de configuration 
paramètre de retour : (long) adresse page de base si chargement code du 
programme appelé si chargement et exécution, 
négatif si erreur 


Les principes de chargement et d'exécution d’un programme ainsi que 
la signification des pointeurs ci-dessus sont détaillés au chapitre 4. 


TRAP 1 fonction $4C : Pterm (a) SERA 
Termine un programme 
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paramètres d’appel : (mot) code du programme retourné par Pexec 
paramètre de retour : négatif si erreur, 0 sinon. 


cf. fonction Pexec ci-dessus. 


TRAP 1 fonction $4E : Fsfirst (a,b)  SFIRST 
Recherche la première occurrence d’un fichier 


paramètres d’appel : (long) adresse de la chaîne contenant le nom 
(mot) attributs de la recherche 
paramètre de retour : 0 si fichier trouvé, négatif sinon. 


Les attributs de recherche correspondent aux attributs de fichier (voir 
fonction $43, Fattrib). La recherche d’une première occurrence n’a vraiment 
de sens que lorsque l’on emploie des “* + *’ ou des “‘?”’ dans le nom de fichier. 
Ce nom doit commencer par la lettre identifiant le disque (A, B...) puis ‘‘:”?, 
etc. comme pour tout nom de fichier. 


Si un premier fichier est trouvé, un bloc d’informations de 64 octets est 
placé à partir de l’adresse fixée par Fsetdta (fonction $1A) ou fournie par 
Fgetdta (fonction $2F). Ce bloc a la structure suivante : 
octets 0 à 20 : inutilisés (réservés) 
octet 21 : attributs du fichier (cf. Fattrib, fonction $43) 
octets 22 à 23 : heure de création du fichier 
octets 24 à 25 : date de création du fichier 
octets 26 à 29 : taille du fichier, en octets 
octets 30 à 43 : nom et extension du fichier trouvé 


TRAP 1 fonction $4F : Fsnext ( ) SUEKT 
Recherche l’occurrence suivante d’un fichier 
paramètres d’appel : aucun 
paramètre de retour : (long) 0 si fichier trouvé, négatif sinon. 


La recherche est effectuée d’après les paramètres d’appel de Fsfirts (voir 
ci-dessus) qui a dû obligatoirement précéder l’appel de Fsnext. Les informa- 
tions en retour sont également stockées à partir de l’adresse placée par Fsetdta 
ou fournie par Fgetdta. 


TRAP 1 fonction $56 : Frename (a,b,c) RENATIE 
Renomme un fichier 


paramètres d'appel : (mot) 0, réservé pour le système 
(long) adresse du nom du fichier existant 
(long) adresse du nouveau nom du fichier 
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paramètre de retour : (long) 0 si opération correcte, négatif sinon. 


L’identificateur du disque (A,B...) doit être identique pour les deux noms 
de fichiers, Attention à ne pas utiliser un nom de fichier déjà existant lors- 
que vous renommez un fichier car il serait recouvert par le fichier renommé. 


TRAP 1 fonction 857 : Fdatime (ab) M2 ©70 À 
Fixe ou demande la date et l’heure de création d’un fichier 
paramètres d’appel : (long) adresse du tampon de stockage date/heure 
(mot) identificateur du fichier 


(mot) 1 pour fixer la date et l’heure. 
0 pour demander la date et l’heure. 


L’heure est formatée dans le premier mot du tampon et la date dans 
le deuxième mot, selon le format décrit dans les fonctions $2A et $2C. 


TRAP 2 


TRAP 2 fonction $0 | ETES 


Termine un programme 


Fonction strictement équivalent à Pterm (Trap 1, fonction $4C), avec 
un code d’appel égal à 0. Termine le programme en cours et rend le contrôle 
au système. 


TRAP 2 fonction $73: 


paramètre d’appel : DO.W = $0073 
paramètre de retour : retourné dans intout(0) 


Exécution d’une fonction GEM VD]. Les paramètres d’appel et de retour 
sont placés dans les variables de base (contri, intin, ptsin, intout, ptsout). 
L'adresse d’une table pointant les adresses de contrl, intin, etc., doit être 
placée dans DI.L (cf. 3.1.3). Se reporter à l’annexe 2 pour le détail de ces 
paramètres d’appel et de retour. 
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TRAP 2 fonction $C8 


paramètre d’appel : DO.W = $00C8 
paramètre de retour : retourné dans intout (0) 


Exécution d’une fonction GEM AEËS. Les paramètres d’appel et de retour 
sont placés dans les variables de base de l’AES (global, control, params, int in, 
int_out, adr_in, adr_out). L'adresse d’une table de pointeurs des adresses 
de global, control, etc., (voir 3.1.3) doit être placée dans DI.L Se reporter 
à l’annexe 2 pour le détail de ces paramètres d’appel et de retour. 


TRAP 2 fonction $C9 
paramètre d’appel : DO.W = $00C9 
paramètre de retour : retourné dans intout (0) 


Réservée au système 


TRAP 2 fonction $FFFF 
Fournit l'adresse de départ des routines VDI. 


paramètre d’appel : DO.W = $SFFFF 
paramètre de retour : DO.L = adresses du ‘‘dispatcher”’ des routines VDI. 


Attention, contrairement, à toutes les autres fonctions des Traps, cette 
fonction réclame un paramètre d’appel ayant l’octet fort signé (en principe, 
l’octet fort est toujours nul). L'adresse longue fournie en retour est celle de 
la routine système de traitement des fonctions VDI. Dans ce cas, pour une 
exécution légèrement accélérée des fonctions VDI. Dans ce cas, i/ faut être 
en mode superviseur (cf. Trap 1, fonction $20, Super ( }). 


TRAP 13 


TRAP 13 fonction $0 QET APR 
Informations sur la mémoire 


paramètres d’appel : (long) adresse d’un tampon de stockage 
paramètre de retour : (long) nombre d’octets disponibles en mémoire 
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Le tampon de 12 octets minimum, est rempli ainsi : 
(long) adresse du tampon de données mémoire MD décrit ci-dessous, 
(long) 0, 
(long) adresse du tampon de données mémoire MD décrit ci-dessous. 


Le tampon de données mémoire MD est structuré ainsi : 
(long) 0, 
(long) adresse de départ de la mémoire libre 


(long) nombre d’octets de mémoire libre 
(long) 0. 


TRAP 13 fonction $1 : Bconstat (a) BeonsTAT 
Demande l’état d’un périphérique en entrée 


paramètres d’appel : (mot) code du périphérique 
paramètre de retour : (long) 0 si périphérique prêt (ou caractère disponi- 
ble, —1 sinon. 


Le code du périphérique (paramètre d’appel) peut être : 
PRN : sortie parallèle 
AUX : entrée-sortie série RS 232C 
CON : entrée-sortie console (ici clavier) 
MIDI (entrée-sortie interface musicale) 
port clavier (envoi de commande au 6301) 
sortie écran de tous caractères 


Un R & D = © 


Les différents périphériques sont validés ou non suivant la fonction appe- 
lée (Bconstat, Bconin, Bconout). On a : 


PRN AUX CON MIDI 6301 écran 


test entrée F non oui oui oui non non 

entrée Ë oui oui oui oui non non 

test sortie ; oui oui oui oui oui non 

sortie ÿ oui oui oui oui oui oui 
Be DNAiN 


TRAP 13 fonction $2 : Bconin (a) 
Attente d’entrée d’un caractère sur un périphérique 
paramètres d’appel : (mot) code du périphérique (voir ci-dessus) 
paramètre de retour : (long) code du caractère (voir Trap. 1, fonction 1) 
L’attente du caractère est infinie, y compris pour l'imprimante. 
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TRAP 13 fonction $3 : Bconout (a,b) ReovouUT 
Envoi d’un caractère sur un périphérique 


paramètres d'appel : (mot) code du périphérique (voir Trap 13, $1) 
(mot) caractère à envoyer 


Pour tous les périphériques, le retour de la fonction ne se fait qu’une 
fois le caractère envoyé, excepté pour l'imprimante ou le retour s'opère au 
bout de 30 secondes si la ligne Busy reste à l’état haut. La différence entre 
le périphérique CON (2) en sortie et le périphérique ‘écran’? (5) tient à ce 
qu'avec ce dernier, tous les codes envoyés sont affichés, même les codes de 
contrôle. Il n’y a donc plus alors d’éditeur (cf. chapitre 5). 


TRAP 13 fonction 4 : Rwabs (a,b,c,d,e) PUASBS 
Lecture ou écriture de secteur(s) sur un disque 


paramètres d’appel : (mot) type d'opération (0 : lecture, 1 : écriture), 
(long) adresse du tampon de stockage, 
(mot) nombre de secteurs à lire ou écrire, 
(mot) numéro du secteur de départ, 
(mot) code du périphérique (0 = disque A, 1= B,...) 
paramètre de retour : 0 si l'opération correcte, négatif sinon. 


TRAP 13 fonction 5 : Setexc (a,b) ÉETeURE 


Fixe ou lit un vecteur 


paramètres d’appel : (mot) numéro du vecteur, 
(long) adresse à placer (1 si lecture) 
paramètre de retour : (long) adresse du vecteur si lecture 
ancienne adresse si écriture 


Les vecteurs $00 à $FF sont les vecteurs 68000. Les vecteurs $100 à S1FF 
sont utilisés par le GEMDOS. Les principaux vecteurs sont décrits au chapi- 
tre 5. 


TRAP 13 fonction 6 Tricahcat 
Fournit la base de temps du timer en millisecondes 


paramètres d’appel : aucun 

paramètre de retour : (long) nombre de millisecondes de la base de temps 
du timer (normalement $14, puisque 50 Hz donnent 
une période de 20 ms). 
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TRAP 13 fonction 7 ET ss 


Fournit l'adresse du bloc de paramètres d’un disque 


paramètres d’appel : (mot) numéro du disque (A=0, B=1, etc.) 
paramètre de retour : (long) adresse du bloc de paramètres du disque O si 
le bloc n'existe pas. 


La structure du bloc de paramètres d’un disque est : 


0 (mot) nombre d’octets par secteur 

2 (mot) nombre de secteurs par bloc (cf. TRAP 1, $36) 

4 (mot) nombre d’octets par bloc 

6 (mot) nombre de secteurs réservés au catalogue 

8 (mot) nombre de secteurs réservés aux tables d’allocation fichiers 

À (mot) identique au précédent + 1 (boot secteur) 

C (mot) nombre total de secteurs réservés du disque 

E (mot) nombre total de bloc du disque (non réservés) 

10 (mot) 0 

12 (mot) nombre de secteurs par piste 

14 (mot) nombre de faces du disque 

16 (mot) nombre de secteurs par piste (9 si simple face, 18 si dou- 
ble face) 

18 (mot) nombre de secteurs par piste 

1A (mot) nombre de secteurs ‘cachés’? (non pris en compte) 


TRAP 13 fonction $8 : Bcostat (a) AcesTaT 
Demande l’état d’un périphérique en sortie 


paramètres d’appel : (mot) code du périphérique (cf. TRAP 13, 1), 
paramètre de retour : (long) —1 si périphérique prêt à recevoir 
0 sinon. 
TRAP 13 fonction $9 : Mediach (a) NEDISen 
Teste s’il y a eu changement de disque dans un lecteur 


paramètres d’appel : (mot) O si lecteur A testé, 1 si lecteur B, 
paramètre de retour : (long) 0 si disque non changé, 1 si le disque peut avoir 
changé, 2 si le disque a changé. 


Le test permet de déterminer si le disque a été changé dans un lecteur 
donné depuis la dernière opération sur ce lecteur. 


TRAP 13 fonction $A : Drvmap( ) IAA L Les 
Retourne la carte descriptive des disques actifs 


aramètres d’appel : aucun 
P 
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paramètre de retour : (long) vecteur descriptif (bit 0 à 1 si le disque A est 
actif, bit 1 à 1 si le disque B est actif, etc.). 


TRAP 13 fonction $B : Getshift (a) KR SET 
Active une des touches spéciales du clavier 


paramètres d’appel : (mot) mode de fonctionnement du clavier 
paramètre de retour : (long) ancien mode de fonctionnement. 


Si le paramètre d’appel est négatif, le mode de fonctionnement est lu. 
Sinon, il est fixé en fonction de chacun des bits du paramètre : 
bit 0 : touche Shift droite (appuyée si 1} 
bit 1 : touche Shift gauche 
bit 2 : touche Control 
bit 3 : touche Alternate 
bit 4 : touche Capslock 
bit 5 : touche Clr/Home 
bit 6 : touche Insert 


Remarque : Le compilateur C de Digital Research « squeeze » le para- 
mètre d’appel de la fonction, qui ne peut donc plus être appelée, sauf modi- 
fication du fichier « osbinds.h ». ‘ 


TRAP 14 


TRAP 14 fonction $0 : Initmous (a,b,c) 
Initialisation du gestionnaire de souris 


paramètres d’appel : (mot) type d’initialisation : 
0 désactive la souris 
1 active la souris, en mode relatif 
2 active la souris, en mode absolu 
4 active la souris, en mode clavier 
(long) adresse d’un bloc de paramètres 
(long) 0. 

paramètre de retour : © si initialisation correcte, — 1 sinon. 
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est Le bloc de paramètres pointé par Le 2° paramètre d’appel à la structure 
suivante : 


00 (octet) 0 si origine verticale de la position de la souris en bas de l’écran, 
1 si origine verticale en haut de l’écran, 

01 (octet) précise le mode d’action des boutons de la souris sur son dépla- 
cement (cf. commande 7 envoyée au 6301, chapitre 5). 

02 (octet) déplacement horizontal de base de la souris 

03 (octet) déplacement vertical de base de la souris 


Si le type d’initialisation est égal à 2, les paramètres suivants doivent figu- 
rer à la suite du bloc précédent : 


04 (mot) position horizontale maximale de la souris 
06 (mot) position verticale maximale de la souris 
08 (mot) position horizontale de départ de la souris 
OA (mot) position verticale de départ de la souris 


TRAP 14 fonction $1 SSREU 
Réservation de mémoire en deçà du haut de la mémoire vive 


4 paramètres d'appel : (mot) nombre d’octets à réserver 


paramètre de retour : (long) adresse du bas de la zone allouée 


Fonction non implémentée dans les systèmes d’exploitation du ST. 


TRAP 14 fonction $2 : Physbase ( ) 
Fournit la base physique de la mémoire d’écran. 


A. paramètres d'appel : aucun 
paramètre de retour : (long) adresse du bas de la mémoire écran. 


TRAP 14 fonction 83 : Logbase ( ) 
Fournit la base logique de la mémoire d'écran 


paramètres d'appel : aucun 
paramètre de retour : (long) base logique de l’écran 


Base physique et logique de l’écran coïncident sur le 520 ST. 


TRAP 14 fonction $4 : Getrez ( ) 
Fournit la résolution courante de l’écran 


paramètres d’appel : aucun 
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paramètre de retour : (mot) 2 si haute résolution, 1 si moyenne résolution, { 
0 si basse résolution. 


TRAP 14 fonction $5 : Setscreen (a,b,c) 
Fixe les données de base de l'écran 
JE Viorn 


A 


paramètres d'appel : (long) base logique de l'écran 
& (long) base physique de l'écran 
Ae (mot) résolution de l’écran (cf. ci-dessus) 


paramètre de retour : aucun Jonckier- 


Si l’un des paramëtres est égal à —1, il n’est pas pris en compte. 


TRAP 14 fonction $6 : Setpallete (a)  SETPALEE TTE 
Fixe les couleurs de la palette courante 


paramètres d’appel : (long) adresse de la palette 
paramètre de retour : aucun . 


La palette adressée par le paramètre d’appel doit être composée de 
16 mots, chacun des mots définissant une couleur (cf. 1.1.2. Système 
graphique). f 


TRAP 14 fonction $7 : Setcolor (a,b) 
Fixe une couleur de la palette courante 


paramètres d’appel : (mot) numéro de la couleur (0 à 15) 
(mot) nouvelle couleur 
paramètre de retour : (mot) données de la couleur modifiée, 


Une couleur est définie par 3 groupes de 3 bits indiquant les niveaux 
de rouge, de vert et de bleu (cf. 1.1.2). 


TRAP 14 fonction $8 : Floprd.(a,b,c,d,e,f,g) 
Lecture de secteur(s) sur un disque 


paramètres d’appel : Hong) adresse du tampon de stockage Be 
& (long) 0 
(mot) numéro du lecteur (A=0, B=1) 
AtGot) numéro du secteur de départ (1 à 9) 
U(mot) numéro de la piste (0 à 79) 
(mot) numéro de la face (0 ou) # 
AB(mot) nombre de secteurs à lire “i 
paramètre de retour : 0 si lecture correcte, négatif sinon. 


TRAP 14 fonction $9 : Flopwr (a.,b,c,d,e.f,g) 
Écriture de secteur(s) sur un disque 


Les paramètres d’appel et de retour sont exactement semblables à ceux 


TRAP 14 fonction $A : Flopfmt (a,b,c,d,e,f,g,h,i) 
Flopimt, 
Formatage d’une piste d’une face de disque 


paramètres d'appel : (long) tampon de stockage (8 Ko minimum) 
(long) 0 
(mot) numéro du lecteur (A=0, B=1) 
(mot) nombre de secteurs par piste 
(mot) numéro de la piste à formater 
(mot) numéro de la face à formater 
(mot) facteur d’espacement entre secteurs 
(long) $87654321 sur le 520 ST 
(mot) mot de remplissage 

paramètre de retour : 0 si formatage réussi, négatif sinon. 


En cas de formatage défaillant, une liste des secteurs non formatés est 
retournée dans le tampon. Le quartet fort du mot de remplissage (dernier 
paramètre d’appel) ne doit pas être égal à $F. En dehors de cette restriction, 
le mot de remplissage peut être égal à n’importe quelle valeur, y compris 0. 


TRAP 14 fonction $C : Midiws (a,b) 
Envoi d’une chaîne sur le port MIDI 


paramètres d'appel : (mot) nombre de caractères à envoyer — 1 
(long) adresse de la chaîne de caractères 


TRAP 14 fonction SD : Mfpint (a,b) 
Place un vecteur d'interruption du 68901 


paramètres d’appel : (mot) numéro du vecteur (0 à $F) 
(long) adresse à placer dans le vecteur 


L'adresse du vecteur est égale à : $100 + (4 + numéro du vecteur). Se 
reporter au chapitre 5 pour une analyse des vecteurs d’interruptions. 


TRAP 14 fonction $E : lorec (a) 
Fournit l’adresse d’un descripteur de tampon d’entrée série 


À 

| 

| 

Ë de la fonction précédente. 

l 

s 

l 
paramètre de retour : aucun 
paramètre de retour : aucun 

{ 

k 
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paramètres d’appel : (mot) 0 si série RS 232, 1 si clavier, 2 si MIDI 
paramètre de retour : (long) adresse du descripteur de tampon d’entrée. 


Le descripteur de tampon d’entrée à la structure : 


0 (long) : adresse du tampon de stockage des entrées 
4 (mot) : taille du tampon, en octets 

6 (mot) : index du dernier octet entré 

8 (mot) : index du dernier octet saisi 

A (mot) : base du débordement 

C (mot) : haut du débordement 


Le haut du débordement est le nombre d’octets à partir duquel il y a 
envoi d’une demande d’arrêt de transmission (si le protocole XON/XOFF 
ou CTS/RTS est actif). Le bas du débordement est le nombre d’octets en 
dessous duquel la demande de reprise de transmission est envoyée (si un pro- 
tocole est actif). 


Pour l’entrée-série, un descripteur du tampon de sortie série est placé 
juste après le descripteur du tampon d’entrée (14 octets après donc). 


TRAP 14 fonction $F : Rsconf (a,b,c,d,e,f) 
Configuration du port série RS 232C 


paramètres d’appel : (mot) code de la vitesse 

(mot) code du protocole 

(mot) fixe le registre de contrôle général 

(mot) fixe le registre contrôle récepteur 

(mot) fixe le registre contrôle émetteur 

(mot) fixe registre caractère synchronisation. 
paramètre de retour : (long) octet fort des quatre registres précédents 

(anciennes valeurs). 


La vitesse est codée : 


0 : 19200 4 : 2400 8 : 600 C : 134 
1: 9600 5 : 1920 9 : 300 D : 110 
2: 4800 6 : 1745 À : 200 E: 75 
3: 3840 7 : 1200 B : 150 F: 50 


Le protocole est codé : 


0 : pas de protocole (par défaut) 2: RTS/CTS 
1: XON/XOFF (4 et AQ) 3 : XON/XOFF et 
: RTS/CTS 


Le registre de contrôle général a la structure suivante : 
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ss 


es 


bit 7 : doit être à 1 (division par 16 de l’horloge) 
bit 5 et 6 : nombre de bits utiles (00 = 8 bits, 01 = 7 bits, 10 = 6 bits, 
11 = 5 bits) | 
bits 3 et 4 : format de contrôle (00 = pas de START ni de STOP, 01 = 1 
bit de START et 1 bit de STOP, 10 = 1 bit de START et 1,5 
bit de STOP, 11 = 1 bit de START et 2 bits de STOP). Le for- 
mat 00 est déconseillé. 
bit 2 : validation de la parité (1 = parité valide, 0 sinon) 
bit 1: type de parité (1 = paire, 0 = impaire) 
bit0:0 
Le registre de contrôle du récepteur a la structure : 
bits 1 à 7: en lecture (nuls en écriture) 
bit 0 : valide le récepteur à 1, le désactive à 0 
Le registre de contrôle du transmetteur a la structure : 
bits 1 à 7 : en lecture (nuls en écriture) 
bit 0 : valide l'émetteur à 1, le désactive à O0 


Le registre de caractère de synchronisation : 0 sur le 520 ST 


TRAP 14 fonction $10 : Keytbl (a,b,c) 
Fixe les adresses des tables de décodage des touches du clavier 
paramètres d’appel : (long) adresse de la table des minuscules 
(long) adresse de la table des majuscules 
(long) adresse de la table de décodage lorsque Caps- 
lock est enfoncée 
paramètre de retour : (long) adresse ancienne table des minuscules 


Les tables doivent comporter 128 octets, indiquant comment convertir 
un code clavier en code ASCII (voir table de base, Trap 1, fonction 1). 


TRAP 14 fonction $11 : Random ( ) 
Fournit un nombre pseudo aléatoire 


paramètres d’appel : aucun 
paramètre de retour : (long) nombre aléatoire sur 24 bits 


TRAP 14 fonction $12 : Protobt-(a,b,c,d) 
Fabrique une image du ‘‘boot’? secteur d’un disque 


paramètres d’appel : (long) adresse du tampon de stockage 
(long) numéro de série (inchangé si — 1, aléatoire si 
>$01000000) 
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(mot) type du disque (2 si 80 pistes, simple face, 3 
si 80 pistes, double face) 
(mot) rend le secteur exécutable si à 1, non exécuta- 
ble si à 0, inchangé à —1. 
paramètre de retour : (mot) somme de contrôle du secteur (checksum). 


Permet de fabriquer une image du secteur 0, piste 1, pour écriture sur 
un disque ou modification du secteur 0 existant. Le tampon de stockage doit 
comporter 512 octets minimum. 


TRAP 14 fonction $13 : Flopver (a,b,c,d,e,f,g,) 
Vérification de secteur(s) d’un disque 


paramètres d’appel : (long) adresse du tampon de stockage 
(long) 0 
(mot) numéro du disque (A=0, B=1) 
(mot) numéro du secteur de départ à vérifier 
(mot) numéro de la piste du disque (1 à 9) 
(mot) numéro de la face du disque (0 ou 1) 
(mot) nombre de secteurs à vérifier. 
paramètre de retour : (long) 0 si vérification correcte, négatif sinon. 


Le tampon de stockage doit avoir une adresse alignée sur un nombre 
entier de Ko. Au retour, il contient les numéros des secteurs éventuellement 
défaillants. 


TRAP 14 fonction $14 : Priblk () SRE 
Copie d’écran sur imprimante 
paramètres d’appel : aucun 
paramètre de retour : (long) 0 si copie effectuée, négatif sinon. 


La copie d'écran est effectuée en fonction des paramètres existants de 
configuration de l'imprimante. 


TRAP 14 fonction $15 : Cursconf_(a,b) 
Fixe ou lit les attributs du curseur 


paramètres d’appel : (mot) période de clignotement du curseur 
(mot) attributs du curseur 
paramètre de retour : (mot) selon paramètres d’appel 


Le positionnement des attributs s’opère en fonction du 2° paramètre : 
0 : désactivation du curseur 
1 : activation du curseur 
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: rend le curseur clignotant (si actif) 

: rend le curseur fixe (si actif) 

: écriture de la période de clignotement du curseur 
: lecture de la période de clignotement du curseur 


Ur & %w D 


Un paramètre de positionnement d’attributs supérieur à 5 n’est pas pris 
en compte. La ‘‘période de clignotement”” correspond au nombre de cycles 
horloge entre chaque état du curseur (visible/non visible). Elle est fixée à 
30 à l’initialisation du système soit .43 secondes environ de visibilité et donc 
une alternance toutes les 860 millisecondes. 


TRAP 14 fonction $16 : Settime (a) 
Fixe la date et l’heure. 


paramètres d’appel : (long) date et heure 
paramètre de retour : (long) date et heure placées 


La date et l’heure sont formatées comme décrit en Trap 1, fonction $2A 
et $2C (Tgetdate et Tgettime). 


TRAP 14 fonction $17 : Gettime. ( ) 
Lit la date et l’heure 


paramètres d’appel : aucun 
paramètre de retour : (long) date et heure (cf. ci-dessus). 


TRAP jd fonction $18 : Bioskeys ( ) 
Réinitialise les tables de conversion de touches clavier système 
Aucun paramètre d'appel ni de retour. Se reporter en TRAP 14, fonc- 
tion $10 (Keytbl) pour le détail des tables de conversion. 


TRAP 14 fonction $19 : Ikbdws (a,b) 
Envoi de commandes au 6301 (microprocesseur clavier) 


paramètres d’appel : (mot) nombre d’octets à envoyer 
(long) adresse de la chaîne à envoyer 
paramètre de retour : aucun 


Se reporter au chapitre 5, pour le détail des commandes clavier. 


TRAP 14 fonction $1A : Jdisint (a) 
Désactive une interruption du 68901 
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paramètres d’appel : (mot) numéro de l'interruption (0 à $F) 
paramètre de retour : (long) numéro de l'interruption. 


Se reporter au chapitre 5 pour le détail des interruptions. 


TRAP 14 fonction $1B : Jenabint (a) 
Active une interruption du 68901 


paramètres d’appel : (mot) numéro de l'interruption (0 à $F) 
paramètre de retour : (long) numéro de l'interruption. 


TRAP 14 fonction $1C : Giaccess (a,b) 
Lit ou écrit un registre du synthétiseur de son 
paramètres d'appel : (mot) donnée à écrire sur octet faible 
(mot) numéro du registre (bit 7 à O pour la lecture, 
à 1 pour l'écriture) 
paramètre de retour : (octet) donnée lue ou écrite dans le registre. 
cf. chapitre 1, le synthétiseur de son (1.1.3) et chapitre 5 pour des expli- 
cations détaillées sur les registres. Afention aux écritures sur le port À (registre 
$E) qui peuvent être funestes.… 


TRAP 14 fonction $1D : Offgibit. (a) 
Positionnement d’un bit à 0 sur le port A du son. 


paramètres d'appel : (mot) numéro du bit à annuler 
paramètre de retour : aucun 


cf. 1.1.3. pour la fonction de chacun des bits du port À. 


TRAP 14 fonction $1E : Ongibit (a) 
Positionnement d’un bit 1 sur le port À du circuit son 


paramètres d'appel : (mot) numéro du bit (voir ci-dessus) 
paramètre de retour : aucun 


TRAP 14 fonction $1F : Xbtimer (a,b,c,d) 
Initialisation d’un timer du 68901 


paramètres d’appel : (mot) numéro du timer (0 à 3) 

(mot) registre de contrôle du timer 

(mot) registre de données du timer 

(long) adresse de la routine d’interruption 
paramètre de retour : (long) numéro de l'interruption timer 
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Quatre “‘timers”’ sont implementées sur le 68901 : 
À (0) : disponible 
B (1) : utilisé par le système pour rafraîchir l’écran 
C @) : base de temps système réglée à 200 Hz 
D (3) : vitesse série (voir 1.1.3). 


Pour le timer A, seul disponible, le registre de contrôle a les fonctions 
suivantes : 
bits 0 à 2 : division de l’horloge si bit 3 à O (voir 1.1.3) 
compteur d'événements si bits 0 à 4 = $8 
générateur de signaux si bits 0 à 4 > $8. 
bit 4 : timer stoppé si à 0, actif si à 1 
bits 5 à 7 : inutilisés 


Le registre de données fournit la base de temporisation, il est decrémenté 
à chaque cycle de la base de temps. Arrivé à 1, une interruption est générée 
et le programme est dérouté vers la routine d’interruption pointée par le dernier 
paramètre d’appel. Puis le registre de données est rechargé avec sa valeur, etc. 


TRAP 14 fonction $20 : Dosound (a) 
Envoi de commande(s) au synthétiseur de son 


paramètres d’appel : (long) adresse des commandes à envoyer 
paramètre de retour : (long) ancien pointeur des commandes. 


Voir chapitre 5 pour le détail des commandes 


TRAP 14 fonction $21 : Setprt (a) 
Fixe ou lit la configuration imprimante 


paramètres d’appel : (mot) configuration (lecture si —1) 
paramètre de retour : (mot) configuration de l'imprimante. 


La configuration de l’imprimante est fixée ainsi : 


bit Q : O si matricielle, 1 si marguerite 

bit 1 : O0 si monochrome, 1 si couleur 

bit 2 : 0 si 1280 points/ligne, 1 si 960 points/ligne 
bit 3 : qualité épreuve si 0, définitive si 1 

bit 4 : 0 si sortie parallèle, 1 si sortie série 

bit 5 : O si listing, 1 si feuille 

bits 6 à 15 : inutilisés (le bit 15 doit être nul). 


TRAP 14 fonction $22 : Kbdybase ( }) 
pi AMP É ELA 
Demande l'adresse de base du descripteur de vecteurs clavier 
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paramètres d'appel : aucun 
paramètre de retour : (long) adresse de base du descripteur 


L'adresse retournée pointe sur la structure suivante : 


0 (long) adresse routine d'entrée MIDI 

4 (long) adresse routine traitement erreur clavier (rts !) 
8 (long) adresse routine traitement erreur MIDI (rts !) 
C (long) adresse routine de test clavier (rts !) 

10 (long) adresse routine d'interruption souris 

14 (long) adresse routine d’interruption horloge 

18 (long) adresse routine d'interruption manette de jeu 


‘a 


TRAP 14 fonction $23 : Kbrate (a,b) 
Fixe ou lit la fréquence d’autorépétition des touches du clavier 


paramètres d’appel : (mot) délai avant autorépétition 
(mot) délai entre auto-répétitions 

paramètre de retour : (mot) octet fort = délai avant autorépétition, 
octet faible = délai entre autorépétitions. 


Les délais sont exprimés en multiples de la base de temps, soit 20 ms. 
Si l’un des paramètres est égal à —1, il est lu et non écrit. 


TRAP 14 fonction $24 ART BE 
Copie d’écran sur imprimante paramétrable 


paramètres d’appel : (long) adresse du bloc de paramètres 
paramètre de retour : 0 si copie, —[ si erreur. 


Le bloc de paramètres doit comporter au moins 30 octets. Il doit avoir 
la structure suivante : 


0 (long) adresse du début de la mémoire d’écran à copier 
4 (mot) 0 
6 (mot) nombre de points horizontaux à copier 
8 (mot) nombre de points verticaux à copier 
A(mot) 0 
C (mot) nombre de points horizontaux de l’écran 
— nombre de points horizontaux à copier 
E (mot) résolution (2 = haute, 1 = moyenne, 0 = basse) 
10 (mot) qualité (0 = épreuve, 1 = définitif) 
12 (long) adresse de la palette de couleurs 
16 (mot) 0 si matricielle noir et blanc 1280 points/ligne 
1 si matricielle couleur 1280 points/ligne 
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2 si marguerite noir et blanc Atari 
3 si matricielle noir et blanc 960 points/ligne 
—1 sinon (pas de copie d’écran...) 
18 (mot) 0 si sortie parallèle, 1 si sortie série 
1A (long) adresse table de conversion des couleurs (table de 16 octets, dont 
les 4 bits faibles traduisent chaque couleur) 


Attention, cette fonction (ainsi que les fonctions $26 et $27) ne sont pas 
documentées et leur utilisation réclame quelques précautions. Ainsi cette copie 
d’écran ne fonctionnera que si l’on a placé auparavant 1 dans la variable 
système $4BE (drapeau de copie). 


TRAP 14 fonction $25 WvEE 
Attente de la prochaine interruption ‘verticale’? 


Aucun paramètre, La routine appelée attend simplement l'interruption 
fréquence de trame. A utiliser pour la synchronisation graphique. 


TRAP 14 fonction $26 SUPEXÉC 
Exécution d’une routine en mode Trap 


paramètres d'appel : (long) adresse de la routine à exécuter 
paramètre de retour : selon votre bon plaisir 


Permet de faire exécuter une routine que vous avez écrite comme un 
Trap, c’est-à-dire en mode superviseur et sans trace. Cette routine doit se 
terminer par un rts (le retour d’interruption est assuré par le système). Les 
registres D3 à D7 et A3 à A7 sont restitués inchangés. 


TRAP 14 fonction 827 PONTAES 
Suppression de l’AES du système 


Aucun paramètre, Fonction sans doute inutilisable une fois que le GEM 
sera en mémoire morte... À manipuler avec une extrême précaution, certai- 
nes modifications étant indispensables (par exemple une désactivation de la 
ligne F, cf. chapitre 3). 
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ANNEXE 5 


INSTRUCTIONS DU 68000 


L'ensemble des instructions du 68000 est ici fourni dans l’ordre alpha- 
bétique. Les abréviations suivantes sont utilisées : 


<Donnée> 
Dn 

An 

USP 


désigne une donnée immédiate 

désigne un registre de donnée 

désigne un registre d’adresse 

désigne le pointeur de pile utilisateur 

désigne le registre d’état (16 bits) 

désigne le registre de condition (octet faible de SR) 
désigne un registre de donnée source . 
désigne un registre de donnée destination 

désigne un registre d’adresse source 

désigne un registre d'adresse destination 

désigne une Adresse Effective d’une position mémoire 
correspondent aux tailles Octet, Mot et Long mot 


Dans la colonne de droite, modes d’adressage, les adressages autorisés 
sont marqués d’une croix. On a: 


adressage registre de donnée 

adressage registre d’adresse 

adressage indirect 

adressage indirect post-incrémenté 

adressage indirect pré-décrémenté 

adressage indirect avec déplacement 

adressage absolu (court ou long) 

adressage relatif à PC (avec ou sans déplacement) 
adressage immédiat 
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X,N, Z, V, C, correspondent aux indicateurs du registre de conditions 
(pour ces indicateurs, $ ou 1 correspond à un positionnement obligatoire, la 
lettre P correspond à un positionnement en fonction du déroulement de l’ins- 
truction et la lettre I à un positionnement indéfini). 
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PR ame oo pp mn me HR 


Cet ouvrage vous fait pénétrer au coeur du. ST, à travers une étude 
précise du TOS et du GEM, illustrée de nombreux exemples. Parmi 
ceux-ci, une calculatrice et un DISQUE VIRTUEL, listés et commen- 
tés, vous permettront de disposer de deux applications utiles, 

Les méthodes et les erreurs de programmation, tant en langage C qu'en 
assembleur 68000, font l'objet de développements. importants. Au 
programmeur confirmé, une analyse des lignes «A» et «F» ainsi qu'unê 
analyse du circuit clavier ouvriront des perspectives nouvelles. 


+ 


En annexes, toutes les primitives système et les fonctions GEM sont 
étudiées une par une, un index détaillé permettant une utilisation op- 
timale des informations ainsi disponibles. va 
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